SC33-0069-2 


Program Product 


Customer Information 
Control System/Virtual 
Storage (CICS/VS) 
Version 1, Release 4 

System Programmer’s 
Reference Manual 

Program Numbers 5740-XX1 (CICS/OS/VS) 
5746-XX3 (CICS/DOS/VS) 



| Third Edition (June 1978) 

This edition applies to Version 1, Release 4 (Version 1.4) of the IBM program product 
Customer Information Control System/Virtual Storage (CICS/VS), program numbers 5746-XX3 
(for DOS/VS) and 5740-XX1 (for OS/VS). Until the OS/VS version is released, the 
information in this publication applicable to CICS/OS/VS only is for planning purposes only. 

I This edition is a major revision of the CICS/VS Version 1.3 edition SC33-0069-1. Changes 
I from that edition are indicated by vertical lines to the left of the changes. 

Information in this publication is subject to change. Any such changes will be published 
in new editions or technical newsletters. Before using this publication, consult the latest 
IBM System/370 Bibliography , GC20-0001, to learn which editions and technical 
newsletters are applicable and current. 

A form for readers’ comments is provided at the back of this publication. If the form has 
been removed, address comments to IBM United Kingdom Laboratories Ltd., Technical 
Documentation Department, Hursley Park, Winchester, Hampshire, S021 2JN, England. 

IBM may, if it wishes, use or distribute any of the information you supply in any way it 
deems appropriate without incurring any obligation to you. You may, of course, continue 
to use the information you submit in any way you like. 

I Publications are not stocked at the address given above. Requests for copies of IBM 
publications should be made to the IBM branch office serving your locality. 

| ©Copyright International Business Machines Corporation 1977,1978 


ii 



Preface 


This manual contains detailed information for implementing IBM program 
products CICS/DOS/VS and CICS/OS/VS. It provides system programmers and 
system analysts with information that is primarily independent of the 
operating system; for example, it describes the use of CICS/VS macro 
instructions to generate CICS/VS management programs and service 
programs and to prepare system control tables and service tables. It is 
assumed that the reader has some knowledge and/or experience of the 
Basic Telecommunications Access Method (BTAM), the Telecommunications 
Access Method CTCAM), the Virtual Telecommunications Access Method 
(VTAM), or the Extended Telecommunications Modules (EXTM). 

This publication contains eight major parts: 

• Part 1.. "Introduction” describes the organization of the manual 
and the methods used in presenting the information. There is also 
a brief discussion on code compatibility across previous versions 
of CICS/VS. 

• Part 2. "System Generation" describes the macros and operands 
available for generating CICS/VS system programs. 

• Part 3. "Table Preparation" describes the macros and operands 
which may be used to generate CICS/VS system tables,. 

• Part 4. "Recovery/Restart" contains reference and tutorial 
information on the facilities available for generating CICS/VS 
support for restoring the system after such abnormal conditions as 
a transaction abend, a system abend, and errors detected from 
terminals and logical units. 

• Part 5. "Device and Access Method Support" provides guidance on 
system programming considerations relevant to certain device types 
and access methods. 

• Part 6. "Modifying CICS/VS" describes ways in which the system 
programmer may tailor the CICS/VS system to the requirements of the 
installation. 

• Part 7. "Data Set Considerations" contains information which the 
system programmer may require to access files* 

• Part 8. "Host Processor Resource Utilization" gives detailed 
information on storage estimates in CICS/VS. 

The manual also contains the following appendixes: 


- Appendix A. Required Entries in CICS/VS Tables 

- Appendix B. Examples of Terminal Control Table Preparation 

- Appendix C. Program Generation Summary 

- Appendix D. Cross-Reference Table of CICS/VS macros and operands 

- Appendix E. Error Messages and Codes 

- Appendix F. Sample TCAM SNA Message Control Programs 
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References to CICS or CICS/VS in this publication relate to 
| CICS/DOS/VS and CICS/OS/VS. In addition, the term VTAM refers 
| exclusively to the program product ACF/VTAM, program number 5746-RC3 
j (for CICS/DOS/VS) or 5735-RC2 (for CICS/OS/VS). 

This manual should be used in conjunction with the appropriate 
CICS/VS System Programmer*s Guide when generating the CICS/VS system and 
when preparing the system tables which describe the environment that 
CICS/VS is to support. 

For further information concerning CICS/VS, see the following IBM 
publications: 

Customer Information Control System/Virtual Storage (CICS/VS) 

Version 1, Release 4 : 

General Information , GC33-0066 

System/Application Design Guide , SC33-0068 

Application Programmers Reference Manual (Command Level) , SC33-0077 
I Application Programmer's Reference Manual (RPG II) , SC33-0085 

Application Programmers Reference Manual (Macro Level) , SC33-0079 
Operator's Guide , SC33-0080 

System Programmer's Guide (DOS/VS) , SC33-0070 
System Programmer's Guide (OS/VS) . SC33-0071* 

Introduction to Program Logic , SC33-0067 
Program Logic (DOS/VS) . LY33-6028 
Program Logic (OS/VS) , LY33-6029* 

Messages and Codes . SC33-0081 
1 Problem Determination Guide , SC33-0089 

| IBM 3600/3630 Guide , SC33-0072 

IBM 3650 Guide , SC33-0073 
IBM 3767/3770 Guide , SC33-0074 
IBM 3790 Guide , SC33-0075 
| CICS/DOS/VS-ELS User's Guide , SC33-0086 

Program Debugging Reference Summary , SX33-6010 
I Master Terminal Operator's Reference Summary , SX33-6011 

I Application Programmer's Reference Summary (Command Level) , GX33-6012 

I 

j * Available with CICS/OS/VS Version 1, Release 4. 

The following IBM publications are also referred to in this 
publication: 
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DQS/VS System Control Statements , GC33-5376 

DOS/VS Basic Telecommunications Access Method , GC27-6989 

DQS/VS Supervisor and I/O Macros , GC33-5373 

QS/VS Basic Telecommunications Access Method , GC27-6980 

OS/VS Data Management Macro Instructions , GC26-3793 

OS/VS1 JCL Reference , GC24-5099 

OS/VS2 JCL , GC28-0692 

IMS/VS Utilities Reference Manual , SH20-9029 
Component Description 7770 Audio Response Unit Model 3 , 

GA27-2712 

I IMS/VS Version 1 System Programming Reference Manual . SH20-9027 

IMS/VS System/Application Design Guide , SH20-9025 
OS/VS1 Planning and Use Guide . GC24-5090 
OS/VS2 Planning and Use Guide , GC28-0600 
OS/VS1 Data Management for System Programmers , GC26-3837 
OS/VS2 System Program Library: Data Management , GC26-3830 
OS/VS1 Storage Estimates , GC24-5094 
OS/VS2 Storage Estimates , GC28-0604 

DL/I DOS/VS Utilities and Guide for the System Programmer , 
SH12-5412 

DL/I DOS/VS Application Programming Reference Manual Guide , 
SH12-5411 

3735 Programmers Guide , GC30-3001 

System/7 MSP/7 Host: Program Preparation Facilities II on Guide 
System/360 or System/370: Assembler, Linkage Editor, Formatting 
Utility, and Source Preparation Program , GC34-0007 
MSP/7 Macro Library/Relocatable: Coding the Input/Output 
Macros , GC34-0020 

IBM 3600 Finance Communication System Feature Description 
for BSC3 Communication , GC22-9026 
OS/VS TCAM System Programmers Guide , GC30-2051 
OS/VS TCAM Application Programmer*s Guide , GC30-3036 
OS/VS TCAM Installation and Migration Guide , GC30-3039 
OS/VS TCAM Concepts and Applications , GC30-2049 
I IBM 3270 Information Display System Component Description , 

| GA27-2749 
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Summary of Amendments to the Third Edition 


The following information has been added in the third edition of the 
manual to cover the features provided by CICS/VS Version 1, Release 4: 

• System Generation 

DFHSG PROGRAM^ISC has been added to provide intersystem 
communication support between two or more connected CICS/VS 
systems, or inter-region communication between CICS/OS/VS and 
the DL/I batch region. 

RPG II (CICS/DOS/VS only) and assembler language are supported 
under the command level application programming interface, and 
are specified in DFHSG PROGRAM=EXP. 

• Table Preparation 

Intersystem communication support is provided through the 
DFHTCT TYPE=ISLINK, DFHDCT TYPE=REMOTE, DFHFCT TYPE=REMOTE, and 
DFHTST TYPE=REMOTE macro instructions. Inter-region 
communication between CICS/OS/VS and the DL/I batch region is 
provided through the DFHTCT TYPE=IRCBCH macro and the IRBUFSZ 
operand in DFHSIT. 

The transaction restart facility may be used to restart 
transactions automatically after an abnormal termination and 
subsequent dynamic transaction backout. This facility is 
provided through the RESTART operand in DFHPCT TYPE=ENTRY. 

The 3770 Data Communication System may be used under VTAM in a 
manner similar to the 3790 full function logical unit. 
TRMTYPE=3770 and SESTYPE=USERPROG must be specified in the 
DFHTCT TYPE=TERMINAL macro. 

The execution (command level) diagnostic facility (EDF) allows 
command-level application programs to be debugged before the 
program is executed. This facility is provided through the 
DFHPPT macro instruction. Appendix A contains further 
information. 

New 3270 displays and printers can be used with CICS/VS. 
Information on how to generate this support can be found in the 
DFHPCT TYPE=INITIAL, DFHPCT TYPE=ENTRY, and DFHTCT 
TYPE=TERMINAL macros, and in Appendix D. 

In addition, the following technical and editorial changes have been 
made in this edition of the manual: 

• The macros of the destination control table, the file control 
table, and the terminal control table are arranged in alphabetic 
order within the TYPE=INITIAL and TYPE=FINAL macros. 

• The DFHTCT TYPE-GPENTRY macro (for CICS/DOS/VS only) is documented 
in full. 

• Chapters 2.3, 2.4, 3.3, and 3.4 have been created from the 
recovery/restart and DL/I information that were formerly in 
Chapters 2.2 and 3.2. 
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• Chapters 4.2 ("The Terminal Error Program") and 4.3 ("The Node 
Error Program") have been formed from the information that was 
formerly in Chapter 4.3. The information on system abends 
(formerly Chapter 4.2 ) now appears in Chapter 4.10. 

• The DFHPCT TYPE=GROUP and DFHPPT TYPE=GR0UP macros have been added 
to the program control table and processing program table 
respectively, and allow the system programmer to specify CICS/VS- 
supplied transaction identifications and application program names 
in a simplified manner, on a function basis. Appendix A contains 
further information. 

• Part 8 ("Host Processor Resource Estimation") has been restructured 
and expanded. 

All changes are indicated by a revision bar in the left-hand margin. 
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Summary of Amendments to the Second Edition 


Information on the following new features has been included in the 
second edition of the manual, SC33-0069-1, for CICS/VS Version 1, 
Release 3s 

• Enhanced TCAM support, which allows devices on TCAM lines to be 
used in an SNA network. The main areas of the manual affected by 
this are: 

DFHTCT TYPE=LINE 


New TCAMFET=SNA operand 
Chapter 5.3. 


Discussion on CICS/OS/VS/TCAM SNA considerations 
Appendix F. 

Two sample TCAM SNA message control programs. 

• The addition of the BASE operand in DFHFCT TYPE=DATASET, which 
enables the user to specify the base data set in an alternate index 
structure. 

• Additional formatted dump program features provided by the FDUMP 
parameters in DFHPCT TYPE=INITIAL and in TYPE=ENTRY. 

• Appendix E has been extended to restore the descriptions of the 
error conditions detected by DFHTCAP and by DFHACP. 

In addition, in Technical Newsletter SN33-6233, information on the 
following topics has been added: 

• Program isolation scheduling. The ENQPL and PISCHD operands have 
been added to DFHSIT for CICS/OS/VS only. 

• New 3270 printers and displays/ Details on how to generate support 
for these devices in an SNA environment can be found in the 
discussion on the TRMTYPE/SESTYPE operands in DFHTCT TYPE=TERMINAL. 

• Recovery procedures for a multiprocessor environment, which can be 
found in Chapter 4.9.. 

These additions and all other changes of a technical and editorial 
nature are indicated by revision bars in the left margin. 


Summary of Amendments 
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Summary of Amendments to the First Edition 


This publication supersedes, for CICS/VS Version 1, Release 3, the 
CICS/VS System Programmers Reference Manual , SC33-0054,. 

The following changes have been made to the structure of the manual: 

• Information has been arranged in Parts, each consisting of a 
varying number of chapters* 

• System program generation and system table preparation macro 
instructions are arranged alphabetically in Parts 2 and 3* The 
optional operands in these macros are also arranged alphabetically. 
In certain cases, however, (for example, in DFHFCT TYPE=DATASET and 
DFHTCT T YPE=TERMINAL) the optional operands are presented 
alphabetically on an access method basis in the syntax notation 
display, and in a purely alphabetic order in the description of the 
operands which follows that of the required parameters* 

• Chapter 5 of the Version 1.2 edition of the manual has been broken 
down into shorter and more logical sections, and now appears in 
Parts 4 through 7. 

• Information on logical units has been included from the former 
CICS/VS Advanced Communication Guide to form Chapter 5.2. Appendix 
D from the same manual now forms part of Appendix E. 

• 3600 BSC information has been included in Chapter 5.8. 

• The information on storage estimates has been completely rewritten. 
See Part 8: Host CPU Resource Estimation. 

• Appendix D has been added. 

The following technical changes have been made to cover the new 
features and enhancements provided in CICS/VS Version 1.3: 

• Command-level programming interface for application program 
processing. This is provided by the new system generation macros: 

DFHAG PROGRAM— ElP 
and DFHSG PROGRAM=EXP• 

• Dynamic transaction backout which backs out the effects of a single 
transaction which terminates abnormally. Support is generated by: 

DFHSG PROGRAM=DBP 

DTB operand in DFHSG PROGRAM=JCP and DFHPCT TYPE=ENTRY 
DBP and DBUFSZ operands in DFHSIT. 

• Selective transaction abend which enables a program to recover and 
continue after a system abend. 

• Storage violation partition dump, provided by the SVD operand of 
the system initializstion table. 

• Installability 

the STAGE2 operand in all system generation programs may be 
used to suppress generation of any module for which a pre¬ 
assembled version is supplied on the start system library. 
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new system management program operands in DFHSG TYPE=INITIAL 
for OS/VS only, 

• Enhanced support for logical units. The functions include: 

3270 compatibility for IBM 3790 logical units, including 
support for IBM 3790 Version 6 

New SESTYPE parameters in DFHTCT TYPE=TERMINAL 

The data interchange program, generated by DFHSG PROGRAM=DIP 

Extended local LDC list, generated by specifying LOCAL= in 
DFHTCT TYPE=LDC. 

• High performance option (HPO) which is available under MVS (OS/VS2 
and later) and provides a fast path for accessing control 
intervals. This is known as improved control interval processing 
(ICIP) under VSAM. The parameters which provide this support are: 

SRBSVC in DFHSG TYPE=INITIAL 

DATA, INDEX, and MODE operands in DFHFCT TYPE=DATASET 
DFHFCT TYPE=ALTERNATE macro. 

• File control split modules 

the DFHFCD module, for 0S/VS only, is generated in DFHSG 
PROGRAM=FCP to handle BDAM and ISAM code. 


Summary of Amendments 
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Part 1 


Introduction 




Chapter 1.1. Introduction 


This manual is one of four manuals providing information about the 
design and installation of a CICS/VS system as follows: 

• CICS/VS System/Application Design Guide provides information for 
system design teams and systems analysts on the functions and 
facilities available in CICS/VS and which may be suitable for a 
particular installation or application, 

• CICS/VS System Programmer's Guide (DOS/VS and OS/VS) provides 
details on how to build and install a CICS/VS system. 

• CICS/VS System Programmers Reference Manual provides detailed 
information on the macros and operands available to the system 
programmer for generating and maintaining the CICS/VS system. 

The system programmer should be familiar with the information in the 
appropriate CICS/VS System Programmer's Guide on the improved 
installability aspects of CICS/VS (such as pregenerated modules) before 
using this manual. 


| STRUCTURE OF THIS MANUAL 


The information in the manual is divided into parts, each containing one 
| or more chapters, dealing with specific topics. Each part has an 
| introductory chapter which outlines the information contained in that 
| part. Parts 2 and 3, which deal with system generation and system table 
preparation respectively, are organized in alphabetical order by program 
and table acronym (for example, DFHSG PROGRAM=ATP precedes DFHSG 
| PROGRAM=CSO). The only exceptions to this rule are that TYPE=INITIAL 
| and TYPE=FINAL take their logical places at the beginning and end. In 
I addition to this, the operands within each program and table macro are 
| alphabetic order within the following structure: 

• Required operands for DOS/VS and OS/VS 

• Optional operands for DOS/VS and OS/VS 

• Optional operands for DOS/VS only 

• Optional operands for OS/VS only. 

The remainder of the manual comprises tutorial and reference 
information on other aspects of the CICS/VS system programmers 
responsibilities. As with Parts 2 and 3, each part begins with an 
introductory chapter and, where applicable, operands within macros are 
listed alphabetically. 


| SYNTAX NOTATION 


The symbols [],{}, | and ,... are used in this publication to help 
define the macro instructions. THESE SYMBOLS SHOULD NOT BE SPECIFIED; 
they act only to indicate how a macro instruction may be written; their 
definitions are given below: 
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[ ] 

indicates optional operands. The operand enclosed in the 
brackets (for example, [FB]) may or may not be specified, 
depending on whether or not the associated option is desired. 

If more than one item is enclosed in brackets (for example, 
[BLOCKED|UNBLOCKED]), one or none of the items may be 
specified. Any default value available is indicated by an 
underscore and will be taken if an option from the group is not 
specified. 

{ > 

indicates that a choice must be made. One of the operands from 
the list within braces separated by a | symbol (for example, 
{YES|NO}) may be specified, depending on which of the 
associated services is desired. Any default value is indicated 
by an underscore. 


indicates that a choice must be made between the operands which 
are separated by this symbol. 


indicates that more than one set of operands may be designated 
in the same macro instruction. 


| FORMAT OF MACRO INSTRUCTIONS 


The CICS/VS macro instructions are written in assembler language and, as 
all assembler language instructions, are written in the following 
format: 


r-1 

iii i i 

I Name | Operation | Operand | Comments | 

III I I 

| blank | DFHxxxxx | One or more operands | | 

| or I j separated by commas | j 

| symbol j | II 

III I I 

t-j 


The operand field is used to specify the services and options to be 
generated. Operands are always in a keyword format and any parameters 
are specified according to the following general rules: 

• If the parameter associated with the operand is written in all 
capital letters (for example, TYPE=INITIAL), the operand and 
parameter should be specified exactly as shown. 

• If the parameter associated with the operand is written in lower 
case letters, the operand should be specified exactly as shown and 
the indicated value, address, or name for the lower case letters 
(for example, DATASET=name) should be substituted. 

• Commas and parentheses are specified exactly as shown, except that 
a comma following the last operand generated by the programmer 
should be omitted. The use of commas and parentheses is indicated 
by brackets and braces, exactly as operands. The parentheses may 
be omitted when only one parameter of a particular operand is used. 
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• Because a blank character indicates the end of the operand field, 
the operand field must not contain blanks except within quotes, 
after a comma on a continued line, or after the last operand of the 
macro instruction* The first operand on a continuation line must 
begin in column 16* 

• When a CICS/VS macro instruction is written on more than one line, 
each line containing part of the macro instruction (except the last 
line) must contain a character (for example, an asterisk) in column 
72, indicating that the macro instruction is continued on the next 
line. 


| CODE COMPATIBILITY 


The following definition of compatibility of system programming 
| interfaces applies to users changing from Version 1, Release 1*0, 1*1, 

| 2, or 3 of CICS/VS to Version 1, Release 4. Users of these and earlier 
releases should also refer to the "Memorandum to Users" distributed with 
| Version 1, Release 4 for a further discussion of compatibility, and to 
the CICS/VS Application Programmer *s Reference Manual (Macro Level) for 
a definition of application program compatibility. 

The system programming interfaces to CICS/VS fall into three 
categories: 

| • Object compatible interfaces (code that need not be reassembled) 

| • Source compatible interfaces (code that must be reassembled) 

• Interfaces for which neither source nor object compatibility is 
guaranteed 


| OBJECT COMPATIBLE INTERFACES 


The following macro instructions generate code which is compatible 
across the above-mentioned releases: 

DFHJC 

DFHJC TYPE—OPEN 
DFHJC TYPE=CLOSE 
DFHJC TYPE= GETB/GETF 
DFHJC TYPE=NOTE/POINT 
DFHJC TYPE=(GETJCA,OPEN) 

DFHOC 

DFHOC TYPE=OPEN 
DFHOC TYPE=CLOSE 
DFHOC TYPE=SWITCH 

DFHKP 

DFHKP TYPE=RTBOCTL 
DFHKP TYPE=RTBODATA 
DFHKP TYPE=RTBOEND 
DFHKP TYPE=CHECK 

DFHPC 

DFHPC TYPE=SETXIT 
DFHPC TYPE=RESETXIT 
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Note ; Object compatibility also implies source compatibility. 


Control Block and Area Prefix Fields 


Many of the fields in CICS/VS (for example, CSA and TCA) or prefixes to 
user I/O areas (for example, FIOA and TIOA) are directly referenced by 
macro expansions. In addition, these and many other such fields are 
identified as directly accessible to user code. All these fields are 
authorized for system or application programmer use and are unchanged in 
| offset (location), type, or meaning between earlier releases of CICS/VS 
| Version 1 and Version 1, Release 4. Programs that make correct use of 
| them will continue to function under Version 1, Release 4 without being 
recompiled. User code which refers to fields in area prefixes or in 
CICS/VS control blocks which are not defined as part of the object- 
compatible interface may not continue to work. This is particularly 
likely where users refer to fields formerly marked as "unused" or 
| "reserved" in releases of CICS/VS prior to Version 1, Release 4. All 
code containing such references should be recompiled and carefully 
examined, tested and, where necessary, modified to ensure correct 
operation. 

The following is a list of CICS/VS control blocks that form part of 
the system programmer's interface to CICS/VS: 


DFHOCLDS DFHOCODS 

DFHJCRDS DFHTACLE 

A full list of field names contained in these and other CICS/VS 
control blocks which are considered to be part of the application or 
system programmer's interface to CICS/VS is contained in the CICS/VS 
Application Programmer's Reference Manual (Macro Level) for CICS/VS 
Version 1, Release 4. The system programmer should refer to this list 
if there is any doubt about the validity of application or system 
programming references to control block or area prefix fields. 


SOURCE COMPATIBLE INTERFACES 

The following macros and routines are source-compatible across the 
above-mentioned releases: 

• DFHTC CTYPE macros 

• Node error programs (DFHZNEP) 

• Terminal error programs (DFHTEP) 

• Program error programs (DFHPEP) 

System programming code associated with these interfaces should be 
recompiled to ensure continued correct functioning. 


NON-COMPATIBLE INTERFACES 


The following interfaces cannot, by their very nature, be guaranteed 
either source or object compatible between the above-mentioned releases: 
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• System generation macros and Stage 1 output 

• Table preparation macros 

• User-written system initialization overlays 

• CICS/VS-supplied sample node and terminal error programs (DFHZNEP 
and DFHTEP) from earlier releases. 

• User exit routines for CICS/VS management programs 

• User exit routines for the transaction backout program (DFHTBP) 

• User exits in the dynamic transaction backout program (DFHDBP) 

• User exit routines in the asynchronous transaction processor 
(DFHATP) 


The system programmer should be able to decide, by following the 
guidelines above, whether a CICS/VS compatibility problem is the result 
of incompatibility and may therefore be fixed by an APAR, and which of 
the system programs may need to be recompiled. 
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Part 2. System Generation 




Chapter 2.1. Introduction 


The CICS/VS system generation process builds a library containing those 
CICS/VS management programs and service programs required for the needs 
of an installation* The process comprises three steps: 

• Coding a set of CICS/VS system generation (DFHSG) macro 
instructions to specify the required programs and to indicate how 
they should be tailored to meet the needs of the installation. 

• Assembling the macro instructions. 

• Executing the job stream that results from assembly of the macro 
instructions. 

The distribution volume on which CICS/VS is supplied contains a 
starter system library comprising ready-to-use pregenerated CICS/VS 
programs, tables, and sample applications. The DFHSG macro instructions 
can be used for adding to or replacing items in the starter system 
library. It is recommended that the user install the starter system 
core-image library (load library) and tailor individual modules to 
specific needs. For information on the starter system library, refer to 
the appropriate CICS/VS System Programmer* s Guide (DOS/VS or OS/VS). 

Chapter 2.2 describes the system generation macro instructions. The 
process of assembling the macro instructions and executing the resultant 
job stream is described in the appropriate CICS/VS System Programmer B s 
Guide (DOS/VS or 0S/VS). 

Chapters 2.3 and 2.4 discuss the system generation macros and 
operands which must be specified to provide support for CICS/VS recovery 
and restart facilities, and for using DL/I under CICS/VS. Equivalent 
details on system table preparation can be found in Chapters 3.3 and 

3.4. 


CODING THE MACRO INSTRUCTIONS 


A set of CICS/VS system generation macro instructions starts with a 
DFHSG TYPE=INITIAL instruction and finishes with a DFHSG TYPE=FINAL 
instruction. Between these two instructions is coded a series of 
instructions of the form DFHSG PROGRAM=xxx to specify the programs to be 
included in the CICS/VS library. 

DFHSG PROGRAM=xxx macro instructions can be used to specify: 

• CICS/VS management programs 

• CICS/VS service programs 

• CICS/VS utility program 

Some of the management programs and some of the service programs must 
always be specified? all other programs are optional. If some optional 
programs are omitted, dummy programs must be generated? the DFHSG 
PROGRAM=CSD macro instruction can be used for this purpose. 

Figure 2.1 (below) lists all of the programs that can be specified, 
with the names of the relevant macro instructions and an indication of 
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which programs are mandatory and which require a dummy program if 
| omitted. The programs are presented in Figure 2,1 in alphabetic order 
j according to the program acronym, under the headings "Management 
| programs", "Service programs," and "Utility program-" 


2ICS/VS System Generation | 

programs j 

DFHSG | 

PROGRAM= | 

Mandatory | 

Dummy 

PROGRAM^ 

Manaqement proqrams 1 

i 

| 



Dump control program | 

DCP | 

NO | 

YES 

File control program j 

FCP j 

NO | 

YES 

Interval control program j 

ICP | 

YES | 

NO 

Journal control program | 

JCP | 

NO | 

YES 

Task control program | 

KCP j 

YES | 

NO 

Program control program | 

PCP | 

YES | 

NO 

Resend program | 

RSP { 

NO | 

NO 

Storage control program j 

SCP j 

YES | 

NO 

System recovery program | 

SRP | 

NO | 

YES 

Transaction backout program | 

TBP | 

NO | 

NO 

Terminal control program | 

TCP | 

YES | 

NO 

Transient data program | 

TDP I 

NO | 

YES 

Trace control program | 

TRP | 

NO | 

YES 

Temporary storage control | 

TSP j 

NO j 

YES 

program | 

i 

i 



Service proqrams 1 

1 

i 

i 



Asynchronous transaction | 

I 

i 



processing program | 

ATP j 

NO | 

NO 

Built-in functions program j 

BFP | 

NO J 

YES 

Basic mapping support | 

BMS | 

NO | 

YES 

Common system area | 

CSA | 

YES | 

NO 

Control system dummy group | 

CSD | 

NO | 

NO 

Control system operational | 




group | 

CSO | 

YES | 

NO 

Control system service group | 

CSS | 

NO | 

NO 

Dynamic transaction | 

1 



backout program | 

DBP | 

NO | 

NO 

Batch data interchange | 

1 



program | 

DIP | 

NO | 

YES 

EXEC interface program | 

EIP | 

NO | 

NO 

Command (EXEC) language j 

1 



translator program | 

EXP | 

NO | 

NO 

Graphic attention program | 

GAP j 

NO | 

NO 

High level language | 

1 



support group | 

HLL | 

NO | 

NO 

Intersystem communication | 

1 



group | 

ISC | 

NO | 

NO 

Keypoint program | 

KPP | 

NO | 

YES 

Master terminal program | 

MTP | 

YES | 

NO 

Dynamic open/close program | 

OCP | 

t 

NO | 

NO 

Utility proqram 1 

1 

1 

| 



Control system utility group | 

CSU 1 

NO | 

NO 


Figure 2.1. CICS/VS System Generation Programs 
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Chapter 2.2. System Generation 


This chapter describes the macros that may be used to generate a CICS/VS 
system* 

The macro instructions are described in the following orders 

• DFHSG TYPE=INITIAL 

• DFHSG PROGRAM=xxx in alphabetic order of program name 

• DFHSG TYPE^FINAL 

In each case, the operands (except TYPE and PROGRAM, which always appear 
first) are listed in alphabetic order starting with the mandatory 
operands. Operands that apply to DOS/VS only or OS/VS only are listed 
separately in alphabetic order. The syntax notation is described in 
Chapter 1.1. 

Appendix C provides a list of the modules generated by the DFHSG 
macro instructions. 


INITIALIZATION " DFHSG TYPE=INITIAL 


A DFHSG TYPE=INITIAL macro instruction must precede each set of system 
generation macro instructions. Procedures developed from the use of 
this macro instruction can be reused for subsequent generations of the 
entire system or for parts of the system. 

The following modules are generated in response to this macro 
instruction: 

• DFHHPSVC - the service request block (SRB) type 6 SVC for the High 
Performance Option (HPO) 

• DFHCSVC - the page fix/free SVC 

Note : The STARTER= YES parameter is an internal operand used by IBM and 

is not intended for general use. It is documented here for reasons of 
completeness and clarity only. 


Chapter 2.2. 
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DFHSG 


TYPE=INITIAL 

l,ACCTID= C CICS Iaccounting-information}] 

[,ASMBLR={ IFOXOO | ASSEMBLY |assembler-name >] 

[,{DL11DLI}={NO|YES 1 string}] 

{.EJECT={YES In> 3 
[,JOBNAME= CCIOS|jobname}] 

£ ,MOD=(programC,suffix]...,programt,suffix])] 
l,PRINT={ LIST INOLIST} 

{ , XREF |NOXREF|SHORTXREF} 

t-OS/VS 

£,DSECT|NODSECT|SOMEDSECT} 

t-OS/VS 

[,DSLIST]] 

£.STAGE2=£ FORCE 1 SELECTIVE}] 

[,VSAM={YES|NO}] 

£,VSAMSHR= £NO|YES}] 

£.VTAM= £ YES I NO}] 

For DOS/VS Only 

£,DEVICE—{ TAPE 2314|3330133401 3350}] 

For OS/VS only 

£,CICSSVC= £2011number} ] 
f,DEBCHK=£YES|}] 

£,OPSYS= £ VS1»6 IVS21number}] 

£,SMPDATE= £IPLjU j REPLY|yyddd}] 

£,SMPLKED= £ IEWL |name}] 

£,SMPSIZE=(nl»n2)] 

£,SRBSVC=number] 

£,STATUS=FIRST] 

£,TCTUA=( VARIABLE £,V1COMPAT])] 

£,VSAME=£NO|YES}] 

OS/VS JCL OPTIONS 

£,CLASS=jobclassl 
£,CONDCD=((code,operator),...)] 

[,MSGCLAS=xl 
£,MSGLVL=£0|If 2}] 

£.PGMERID= £ * SYSTEM-PROGRAMMER * I'programmer-name'}] 
£,PREFIX=£C ICS j prefix} ] 

£,PRIORTY=nn] 

£,PROCNMS=( DFHASMVS . DFHLNKVS . PFHUPDVS . DFHAUPLK , 
DFHSMPVS , DFHEITCL , DFHEITPL . DFHEITAL ) 

|(procedure-names)] 

£,REGION=storage] 


TYPE=INITIAL 

specifies that this is the initial macro instruction in a 
CICS/VS system generation run. 
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ACCTID=accounting-information 

specifies the JCL accounting information for the CICS/VS 
generation cataloged procedure. The default is ACCTID=CICS. 

For OS/VS, information must not be included within quotes. For 
further details of valid accounting information options, see 
OS/VSl JCL Reference or 0S/VS2 JCL . For DOS/VS, the accounting 
information must be included within in quotes. For further 
information about accounting information, see the DOS/VS System 
Control Statements manual. 

For both DOS/VS and OS/VS, if the accounting information 
contains quotes or ampersands, two quotes or two ampersands 
must be coded for every single one. 


ASMBLR=assembler-name 

specifies the name of the assembler to be used during stage 2 
of system generation and to produce the proper JCL. The system 
modification program will use this name for assemblies. The 
default is ASMBLR=AS SEMBLY for CICS/DOS/VS, and ASMBLR=IFOXOO 
for CICS/OS/VS. 


DLI=NO|YES|string 

specifies whether the Data Language/I (DL/I) interface is to be 
included in this generation of CICS/VS. The default is DLI=NO. 
This parameter should not be specified if DL/I ENTRY DOS/VS is 
being used, but is required if DL/I DOS/VS or IMS/VS are being 
used. For further information, see "DL/I with CICS/OS/VS" in 
Chapter 2.4. 

NO 

indicates that DL/I support is not required 

YES 

indicates that DL/I support is to be included (DOS/VS 
only). If this option is specified, the DL/I exit routines 
module (DFHDLX) must be assembled separately and cataloged 
into the relocatable library as DFHDLX. 

string 

is a string in the form n.n.n (where n is a single digit). 
The string indicates the level of IMS/VS for which 
CICS/OS/VS support is to be included. DLI=1.1.4 or later 
is the only value that can be specified for CICS/VS Version 
1, Release 4. 

Note ; "DLI" may also be written as "DLI". 


EJECT=YES|n 

specifies the effect of page ejects in the assembly listings of 
the CICS/VS modules. The default is EJECT=YES,. 

This operand allows for paper saving by reducing the size of 
the CICS/VS module listings depending on the value chosen for 
"n". This operand has no effect if PRINT=NOLIST is specified. 

YES 

indicates that normal page ejects will occur. 
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specifies a number from 1 to 99 which controls the number 
of spaces to be substituted for page ejects. A separator 
line preceded and followed by a 'space x' statement (where 
x = n-2) will replace page ejects. 


J OBNAME= j obname 

specifies the first part of a JCL (OS/VS) or job control 
(DOS/VS) jobname for system generations. The default is 
JOBNAME=CICS. The complete jobname is a concatenation of the 
jobname operand (truncated to four characters) plus the three 
characters of the program name, plus any suffix (truncated to 
one character, if necessary, to keep within the limit of eight 
characters). For JOBNAME=NEWRUN, PROGRAMMECP, and SUFFIX=03, 
the complete jobname would be NEWRKCPO. For the default 
JOBNAME operand, PROGRAM=KCP, and SUFFIX=2, the jobname would 
be CICSKCP2. 

Notes The program name for DFHSG TYPE=INITIAL is provided by 
the system as GEN. Therefore, the default jobname is CICSGEN. 


MOD=program,suffix 

indicates that the Stage 1 output produced by DFHSG will 
consist only of the jobs for those programs named in this 
operand. All other Stage 2 jobs will be suppressed. Stage 2 
jobs for a program named in this operand will be suppressed 
unless the SUFFIX operand in the appropriate DFHSG PROGRAM=xxx 
macro corresponds to the suffix parameter in the MOD operand. 
This allows APAR fixes to be applied to individual versions of 
the modules produced by DFHSG PROGRAM=xxx macros. 

program 

is the name of a CICS/VS program (for example, TCP), 
suffix 

is the optional suffix appended to the program. If this 
parameter is omitted, an unsuffixed version of the program 
will be searched for in the Stage 1. If ALL is specified, 
all Stage 1 versions will be dealt with. 

Note : If the suffix parameter is omitted, a comma must still 

be specified. 

For example: 


DFHSG TYPE=INITIAL,MOD=(KCP,1A,SIA1,,DCP,ALL,PCP,,TRP,2A) 

DFHSG PR0GRAM=KCP,SUFFIX=1A 

DFHSG PR0GRAM=KCP,SUFFIX=5A 

DFHSG PROGRAM=CSO 

DFHSG PR0GRAM=PCP 

DFHSG PR0GRAM=DCP,SUFFIX=3A 

DFHSG PR0GRAM=DCP,SUFFIX=4A 

DFHSG PR0GRAM=TRP,SUFFIX=2A 

DFHSG PR0GRAM=TRP,SUFFIX=6A 

DFHSG TYPE=FINAL 
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will produce Stage 1 jobs for: 


DFHKCP1A 

DFHSIA1 

DFHPCP 

DFHDCP3A 

DFHDCP4A 

DFHTRP2A 

and will suppress Stage 1 jobs for: 

DFHSPP (from DFHKCP) 

DFHKCP5A 

DFHTRP6A 

All the other jobs normally produced by DFHSG PROGRAM=CSO 


PRINT=print-option 

specifies the printing option for the assembly of the CICS/VS 
modules during stage 2 of system generation. 


LIST 

indicates that the total assembly listing is to be printed, 
NOLIST 

indicates that only assembly error messages are to be 
printed. 

Note : NOLIST, if specified, overrides all options in the XREF, 

DSECT, and DSLIST groups. 

XREF 

indicates that the cross reference list is to be printed. 
NOXREF 

indicates that no cross reference list is to be printed. 
SHORTXREF 

indicates that the cross reference list is to contain only 
symbols which are referenced. This option is valid in 
OS/VS only. 

DSECT 

indicates that all CICS/VS DSECTs are to be printed for 
each program. 

NODSECT 

indicates that none of the CICS/VS DSECTs will be printed. 
All printing, including TWA fields, register equates, and 
comments, is suppressed until the DFHVM macro instruction 
(beginning of the CSECT). 

SOMEDSECT (CICS/0S/VS only) 

indicates that the large DSECTs (CSA, TCA, TCTLE, and 
TCTTE) are not to be printed. 

DSLIST 

indicates that all CICS/VS DSECTs are to be printed as a 
separate listing at the end of stage 2. Thus, to avoid 
having the DSECTs printed twice, NODSECT should also be 
specified. 
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| STAGE2 =FORCE I SELECTIVE 

specifies whether DFHSG will produce Stage 2 jobs for all 
programs requested. The option specified in this macro sets 
the defaults for the STAGE2 operands of the rest of the system 
generation macros. The default for DFHSG TYPE=INITIAL is 
STAGE2=F0RCE. 

Note : A user-supplied suffix on a system generation program 

will be ignored if the Stage 2 job is suppressed, and 
STAGE2=SELECTIVE will be ignored for a given program if the 
user supplies an exit routine name for that program. 

FORCE 

generates the Stage 2 jobs for all system generation 
programs requested, and should be specified if the IBM- 
supplied starter system library is not being used. 

SELECTIVE 

indicates that Stage 2 jobs may be selectively suppressed. 
This option may only be used when programs are being added 
to the IBM-supplied starter system library. 

STAGE2=SELECTIVE causes DFHSG to suppress generation of the 
Stage 2 job for any module if a preassembled version of the 
module has been supplied on the CICS/VS starter system 
library. MNOTEs produced during the Stage 1 assembly 
indicate which jobs have been suppressed and which suffixed 
modules should be used in their place, and which have been 
generated. 


I VSAM=YES|NO 

indicates whether VSAM support is required. The default is 
YES. 

YES 

indicates that VSAM support is required. 

NO 

indicates that VSAM support is not required. This option 
prevents certain assemblies from searching the DOS/VS or 
OS/VS libraries for VSAM macros. 


| VSAMSHR=YES|NO 

specifies whether the VSAM shared resources option is to be 
used. This is available only with OS/VSl Release 4 or later, 
0S/VS2 Release 3 or later, DOS/VS Release 33 or later, or as an 
ICR (independent component release) on 0S/VS2 Release 1.7 
(SVS)• The default is NO. 

YES 

indicates that VSAM resources will be shared. For 
VSAMSHR=YES, VSAM Release 2 must be available in the host 
operating system. VSAMSHR=YES may not be specified if 
VSAM=NO is specified. 

NO 

indicates that VSAM resources are not to be shared. 


| VTAM=YES|NO 

indicates whether VTAM support is required. The default is 
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YES 


indicates that VTAM support is required. 


indicates that VTAM support is not required. This option 
prevents certain assemblies from searching the DOS/VS or 
OS/VS libraries for VTAM macros. 


For CICS/DOS/VS only 


DEVICE=device 

If this parameter is specified, it becomes the default device 
for keypoint, trace control, and dump control programs. Note, 

| however, that DEVICE=TAPE is not allowed for DFHSG PROGRAM=KPP. 

1 If the device type in DFHSG TYPE=INITIAL defaults to TAPE and 

| if the DEVICE operand is not specified in DFHSG PROGRAM^KPP, 

| DFHKPP will override TAPE with 2314 as the device type. 


For CICS/OS/VS only 


ClCSSVC-number 

specifies the SVC number to be used for the CICS/VS page fix or 
anticipatory paging SVC which CICS/VS will provide. This SVC 
is required if page fixing is to be used in CICS/OS/VS. The 
SVC is used if ANTICPG=YES or ANTICPG=number is specified in 
DFHPCT TYPE=ENTRY, if RES=FIX is specified in DFHPPT 
TYPE=ENTRY, or if FIX=YES is specified in DFHNLT TYPE=ENTRY. 
Number may be in the range 200 to 255; the default is 201. The 
number specified must be the same as that used in DFHSIT or in 
the CICSSVC start-up override. 

This operand controls the name given to the SVC routine that is 
generated by the DFHSG TYPE=INITIAL macro. The SVC number is 
copied into the common system area (CSA) from the system 
initialization table at initialization. The SVC number to be 
used can be changed by the CICSSVC operand of DFHSIT. 


| DEBCHK=YES|NO 

| applies only to 7770 devices under OS/VSl or OS/VS2. For 

| OS/VSl, the DEB checking facility is optional and has a default 

j of NO. For OS/VS2, DEB checking is required and has a default 

| of YES. DEBCHK=NO should only be specified if there are no 

| 7770 devices on the OS/VS2 system. 

YES 

indicates that the DEB validity check facility is 
supported. 

| NO 

indicates that the DEB validity check facility is not 
supported. 


| OPSYS=operating-system 

specifies the environment in which CICS/VS is to operate. The 
| default is OPSYS=(VS1,6). 
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VS1JVS2 

indicates the applicable operating system. 


number 

specifies a whole decimal number indicating the release 
number. The maintenance release fraction is not used. For 
example: VS1 Release 6 would be specified as 

0PSYS=(VSl,6), VS2 Release 1.6 would be denoted by 
OPSYS=(VS2 , 1), and VS2 Release 3 would be indicated by 
OPSYS=(VS 2,3). 


SMPDATE=date 

specifies the date that the OS/VS system modification program 
will use when executed. The default is IPL. 

IPL fU 

indicates that the IPL date of the system is to be used. 
REPLY 

indicates that the date must be entered by the operator, 
yyddd 

indicates that the date supplied should be used. (yy=year # 
ddd=day number) 


SMPLKED=name 

specifies the name of the linkage editor to be used by the 
system modification program. The default is IEWL. 


SMPSIZE=size 

specifies the amount of storage to be used by the linkage 
editor. Valid combinations of values accepted by the linkage 
editor are: 


Cnl,n2) 
(nl) 
(nl,) 

(,n2) 

(,> 


The values nl and n2 may be expressed as integers specifying 
the number of bytes, or as a figure, suffixed by the letter K, 
indicating the number of IK blocks of storage. For further 
details on how to specify SMPSIZE, refer to the OS/VS Linkage 
Editor and Loader manual. 
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SRBSVC=number 

specifies, for 0S/VS2 Release 3.7 (with the supervisor 
performance shippable units 1 and 2), the type-6 SVC number to 
be used for invoking the service request block (SRB) routine 
provided by CICS/VS. This routine (DFHHPSVC) must have been 
link-edited into the user's MVS operating system as the 
appropriate SVC number, and is required to obtain access to any 
SRB-dependent functions of CICS/VS (VSAM ICIP support and VTAM 
authorized path). The number specified must be in the range 
200 to 255. The number specified must be the same as that used 
in DFHSIT or in the SRBSVC start-up override. 

This operand causes the necessary CICS/VS modules to be 
generated to support VTAM authorized path and VSAM fast path 
options. The files that are to be accessed via VSAM fast path 
processing (VSAM ICIP) are specified in the MODE operand in 
DFHFCT TYPE=DATASET. 

If SRBSVC=number is specified, CICSSVC=number is also required. 

The SRBSVC=number operand affects the generation of several 
modules, but the actual SVC number chosen only affects the name 
of the SVC routine itself (source name DFHHPSVC). The SVC 
instruction used to pass control to DFHHPSVC is generated in 
the DFHSIT macro. SRBSVC=number can be specified in DFHSIT, 
but only as a means of changing the SVC number to be used. 


STATUS=FIRST 

in CICS/OS/VS, the STATUS=FIRST operand is used to cause the 
CICS/VS cataloged procedures to be placed in SYS1.PROCLIB. In 
CICS/OS/VS, STATUS=FIRST and CICSSVC=number generate a job to 
assemble and link-edit the page fix SVC to SYS1.SVCLIB (VSl) or 
SYSl.LPALIB (VS2). STATUS=FIRST should be used with each new 
release to obtain the latest cataloged procedures. If 
TCTUA=V1C0MPAT is specified, jobs are created, which modify the 
DFHTCT macro instruction and DFHTCT symbolic storage definition 
(DSECT) to provide upward compatibility from CICS/OS-STANDARD 
Version 1. 


TCTUA^VICOMPAT| VARIABLE 

specifies user-defined process control information (PCI) fields 
of fixed length (15 bytes) and/or variable length (0 to 255 
bytes). These fields are located in the terminal control table 
and can be used as terminal work areas. The default is 
TCTUA=VARIABLE. 

VlCOMPAT 

should only be used by users of earlier versions of 
CICS/OS/VS who are currently using the fixed-length 15-byte 
PCI field (the address of which is at TCTTECI) and who 
desire PCI compatibility with CICS/OS-STANDARD Version 1. 
This option must be specified in conjunction with the 
STATUS=FIRST operand. 

Note : If this option is specified, use of the preassembled 

starter system cannot be guaranteed. 

VARIABLE 

specifies a variable-length (byte aligned) PCI field (the 
address of which is at TCTTECIA and the length of which is 
at TCTTECIL) and should be used by all but CICS/OS-STANDARD 
Version 1 users (who have used PCI fields) if a terminal 
work area is desired. 
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VSAME=NO|YES 

indicates whether VSAM enhancements are to be used on OS/VS2 
Release 1 (SVS)• This parameter is ignored for all other 
operating systems. The default is VSAME=NO. 

NO 

indicates that VSAM enhancements are not required. 

YES 

indicates that VSAM enhancements are to be used. VSAME=YES 
may only be used when OPSYS=(VS2,1) is specified. 


OS/VS JCL Options 


The following JCL options may be required for generation of the 
CICS/OS/VS system. For further details refer to the OS/VSl JCL 
Reference or 0S/VS2 JCL manuals. 


CLASS=jobclass 

is used to assign a jobclass to all Stage 2 jobs. 


CONDCD=code 

specifies the condition codes which, if met on any job step, 
cause further processing of that job to be bypassed. 


MSGCLAS=x 

is used to route all messages issued by the OS/VS Job Scheduler 
to an output class. 


MSGLVL=value 

specifies the message level desired for the JCL during Stage 2. 
The OS/VS default is MSGLVL=0. 


PGMERID=programmer-name 

specifies the programmer's name to be placed in the JCL. The 
default is PGMERID=*SYSTEM-PROGRAMMER*. 


PREFIX=prefix 

specifies the index name for CICS/VS system data sets. The job 
control language (JCL) generated specifies these data sets as 
prefix.LOADLIB, prefix.MACLIB, and prefix.SOURCE, where 
"prefix" must conform to the data set naming conventions. The 
default is PREFIX=CICS. 


PRIORTY=nn 

is used to assign a priority to the jobs in Stage 2 of system 
generation. All jobs are given the same priority. 


PROCNMS=procedure-names 

allows the user to specify the names of CICS/VS cataloged 
procedures to be used as follows; 

1. First Name - assembly of CICS/VS programs and user-written 
assembler language programs. 
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2. Second Name - link edit of CICS/VS programs and application 
programs. 

3. Third Name - update of a temporary library during system 
generation. 

4. Fourth Name - assembly and link edit during the preparation 
of system tables. 

5. Fifth Name - the procedure used to execute the system 
modification program. 

6. Sixth Name - translate, compile, and link edit ANS COBOL 
application programs using the command-level interface. 

7. Seventh Name - translate, compile, and link edit PL/I 
application programs using the command-level interface. 

8. Eighth Name - translate, compile, and link edit assembler 
application programs using the command-level interface. 


The default names are: 

PROCNMS=(DFHASMVS,DFHLNKVS,DFHUPDVS,DFHAUPLK,DFHSMPVS,DFHEITCL, 
DFHEITPL,DFHEITAL). 


REGION=storage 

allows the user to specify the maximum amount of storage to be 
allocated to the Stage 2 jobs. 

If REGION=nK is specified (for example, REGI0N=52 k), "n" 
indicates the number of 1024-byte areas of virtual storage to 
be allocated for the job Cn" should be an even number). 

If this operand is omitted, the default value (as established 
in the input reader procedure) is assumed. 

Note : Values for the parameters relating to OS/VS JCL options are not 

edited by CICS/VS. Any errors will not be apparent until Stage 2. 


ATP — ASYNCHRONOUS TRANSACTION PROCESSING PROGRAM 


The asynchronous transaction processing (ATP) facility for reading batch 
input from a device, storing it in a queue, processing the input, and 
then writing it out to another device, is designed specifically for 
handling input from batch terminals such as the 2770, the 2780, or the 
3780. Generally, ATP can also be used from other interactive terminals, 
like the 2741. However, ATP is not intended for, and will not support, 
input from the 3270, 2980, 3740 or 3735, or from any logical unit. 

The system generation macro instruction necessary to generate the 
asynchronous transaction processing program is DFHSG PROGRAM= ATP- 

The following programs are generated in response to this macro 
instruction: 

• Asynchronous transaction control program (DFHATP) 

• Asynchronous transaction input processing programs (DFHRDl and 
DFHRD2) 
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• Asynchronous transaction output processing programs (DFHWT1 and 
DFHWT2) 

• Asynchronous queue purge program (DFHAQP) 

| For information on the control statements that are needed when the 
j asynchronous transaction processing facility is used, refer to the 
I CICS/VS Operator's Guide . 


I 

I 

I 

I 


f - f - 

j DFHSG j PROGRAM=ATP 

j | [.INBUFF=( 1000 inumber}3 

| | [,OUTBUFF={1000|number)] 

| j t,STAGE2={SELECTIVE|FORCE >] 

L_L_ 



PROGRAM=ATP 

indicates that the asynchronous transaction processing group is 
to be generated. 


INBUFF=number 

specifies the size (in bytes) of the input buffer used by the 
asynchronous transaction input processing programs. The value 
specified should not exceed the full track capacity for the 
device being used, or, in the case of CICS/OS/VS, should not 
exceed the block size specified on the intrapartition data set 
data definition (DD) card at startup time. The default is 
INBUFF=1000• 


OUTBUFF=number 

specifies the size (in bytes) of the output buffer used by the 
asynchronous transaction control program. The value specified 
should not exceed the full track capacity for the device being 
used, or, in the case of CICS/OS/VS, should not exceed the 
block size specified on the intrapartition data set data 
definition (DD) card at startup time. The default is 
OUTBUFF=1000. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstrearn for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

I Note : Stage 2 jobs will always be produced for DFHATP, DFHRDl, 

| and DFHRD2. 
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BFP 


BUILT-IN FUNCTIONS PROGRAM 


| The built-in functions program is generated with two options; the basic 
| function and the weighted retrieval function. These options may be 
j specified separately or together through the BUILTIN operand. The 
| facilities generated through the basic function are: 

• Table search 

• Verification of a data field - verify alphabetic or numeric 

• Editing of a data field - removing unwanted characters 

• Phonetic conversion 

• Bit manipulation 

• Input formatting 

| The weighted retrieval function allows the user to search a specified 
| group of records on a VSAM data set and to select only those records 
j which satisfy specified criteria. 


r-r-r-1 

j j DFHSG | PROGRAM=BFP | 

j j | [,BUILTIN= C( BASIC,WTRET }I ([BASIC]1 [WTRET)1)] j 

j j | [,DUMMY=YES] j 

j | | [,STAGE2={SELECTIVE|FORCE}] j 

| | | [,SUFFIX=xx] I 

L_L_L_i 


PROGRAM=BFP 

specifies that the built-in functions program is to be 
generated. 


BUILTIN=function 

specifies which of the built-in function options is desired. 
The default is both functions (BASIC,WTRET). 

BASIC 

generates the basic functions. 

WTRET 

generates the weighted retrieval function. 


DUMMY=YES 

specifies that a dummy built-in functions program is to be 
generated. 

This operand may be used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy built-in functions program. 

Any other operands which may have been included in the DFHSG 
PROGRAM=BFP macro instruction are ignored. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 
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SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 


FORCE 

forces generation of all Stage 2 jobs for this program. 


SUFFIX=xx 

provides a one- or two-character suffix (other than NO or DY, 
which are reserved) for the built-in functions program being 
generated. Only DFHBFP receives this suffix. If this operand 
is omitted, a suffix is not provided. 


Notes : 

1. For CICS/OS/VS, generation of the built-in functions program causes 
the phonetic code conversion subroutine (DFHPHN) to be generated. 
This offline subroutine provides the facility to convert a 16- 
character name to a 4-byte phonetic code. See the "Built-In 
Function" macro instruction DFHBIF TYPE=PHONETIC in the CICS/VS 
Application Programmer*s Reference Manual (Macro Level) for the 
rules of the conversion. 

2. The field-separator and field-name start characters facilitate the 
input formatting function. The field-separator characters are 
specified by the FLDSEP operand of the DFHSIT macro instruction. 

The field-name start character is specified by the FLDSTRT operand 
of the DFHSIT macro instruction. 


B MS — BASIC MAPPING SUPPORT PROGRAM 


All BMS functions are generated by the basic mapping support program. 

| If the BMS program with PAGING or ROUTING is specified, the temporary 
storage program is also necessary. The programs that may be generated 
in response to the parameters in the DFHSG PROGRAM= BMS macro 


instruction 

are 

: 

• 

DFHMCP 

- 

Mapping control program 

• 

DFHPBP 

- 

Page Build program 

• 

DFHIIP 

- 

Non-3270 input mapping 

• 

DFHTPP 

- 

Terminal page program 

• 

DFHM32 

- 

3270 mapping 

• 

DFHDSB 

- 

Data stream builder 

• 

DFHRLR 

- 

Route list resolution 

• 

DFHTPQ 

- 

Terminal page clean-up 

• 

DFHTPR 

- 

Terminal page retrieval 

• 

DFHTPS 

- 

Terminal page scheduling 

• 

DFHFIP 

- 

Faster 2260 compatibility 

• 

DFHF2P 

- 

Faster 2260 compatibility 
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• DFHBMSMM - Pre~VS BMS mapping module 

When requesting BMS to be included in the system during CICS/VS 
generation, considerable flexibility is provided to tailor the amount of 
support included. By choosing only the functions required for a 
particular installation, the size of the working set for the system can 
be significantly reduced. 


I Note : Stage 2 jobs will always be produced for DFHSG PROGRAM=BMS. 


r - 

j DFHSG 

| PROGRAM= BMS 

- -- 1 


i 

| t,BMSCPYC={YES|NO}] 



i 

| [, BMSDDS={NO|YES}] 



i 

I t,BMSDEV=(device.device...)] 



I 

j [.BMSDIAG={NORMAL|MIN|EXTENDED}] 



i 

j [,BMSDRT={YES|NO}3 



i 

j (,BMS FMP={NO j YES}] 



I 

j (,BMSFRL={YES|NO}] 



i 

j [,BMSMBD={YES j NO}] 



I 

j t,BMSNL={<|character}1 



i 

| [,BMSOBF={NO|3270}] 



i 

j t r BMSPB={YES j NO}] 



i 

j [.BMSPGO={YES|NO}3 



i 

| t,BMSPRG={YES j NO}] 



i 

j [,BMSPROP={YES|NO}] 



i 

j t,BMSRCVR={NO|YES}] 



i 

j [,BMSSMI={**-| character}] 



i 

j [,BMSTAB={NO|YES}] 



i 

j {,BMSTXB={YES|NO}] 



I 

j t,COMPAT={PRE-VS|F2260}] 



i 

j [,DUMMY=YES] 



i 

j [,MAP3270={YES|NO}] 



i 

j [,MAPALGN={NO|YES}] 



I 

| [,MAPHC={NO|YES}] 



i 

j {,PAGING={NO|YES}] 



i 

j [,PRGDLAY=hhmm] 



i 

j t,ROUTING={NO|YES}] 



i 

j [ f SKR3270={NO|YES}] 



i 

j I,SUFFIX=xx] 


L_ 

_ i _ __ 


- J 


Note : To use the message switching facility, basic mapping support must 

be generated with ROUTING= YES, PAGING=YES, and, if 3270 terminals are 
involved, MAP3270=YES. 


PROGRAM=BMS 

indicates that basic mapping support is to be generated. This 
causes device independence, or the BMS function, to be 
generated automatically. 


BMSCPYC=YES|NO 

specifies whether the BMS copy command routines should be 
generated. If NO is specified, copy commands should not be 
defined in the DFHSIT macro. Refer to the relevant notes under 
the BMSDEV and MAPHC operands which follow for instances of 
when the BMS copy command should be used. BMSCPYC defaults to 
the same option as specified in the ROUTING parameter. 

Note : The BMS copy command is independent of the copy 

functions provided for certain terminals by TCP and ZCP. 
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BMSDDS= YES 1 NO 

specifies whether support for device-dependent mapset suffixes 
is to be generated. The default is YES. 

YES 

indicates that support for device-dependent mapset suffixes 
is to be generated. If this parameter is specified, BMS 
will attempt to load device-dependent mapsets in preference 
to device-independent mapsets. 

NO 

indicates that support for device-dependent mapset suffixes 
will be deleted. If this operand is specified, TERM=ALL or 
TERM=3270 must be generated in the DFHMSD macro for all 
mapsets. 


BMSDEV=device 

specifies the devices for which BMS support is to be included. 
(Generation of 3270 routines is controlled through either the 
BMSDEV= 3270 or the MAP3270 operands.) 


CRLP card reader/line printer 

TAPE tape support 

DISK sequential disk support 

TWX CPT-TWX (Model 33/35) support 

1050 1050 terminal support 

2740 2740 terminal support (without receive buffer) 

2740BR 2740 terminal support (with receive buffer) 

2741 2741 terminal support, including read attention and 
write break (OS/VS only) 

2770 2770 terminal support 

2780 2780 terminal support 

2980 2980 terminal support, models 1, 2, and 4 

3270 3270 terminal support 

3601 3601 terminal support for all devices, except the 3614, 

using VTAM 

3650UP 3650 User Program support (3650 Interpreter support) 

3653 3653 attached to 3650 support 

3650/3270 3270 attached to 3650 support 

3780 3780 terminal support 

BCHLU batch logical unit support (includes 3770 and 3790 
batch data interchange logical units) 

3770B 3770 Data Communications System support as batch 

logical unit 

INTLU interactive logical unit support 
(flip-flop and contention modes) 

3767 3767 terminal support as interactive logical unit 

37701 3770 Data Communications System Keyboard/printer 

station support as interactive logical unit 
SCS Support for 3767, 37701, INTLU, 3767C, 3770C, 3790 SCS 

printer (SESTYPE=SCSPRT), SCS printer (TRMTYPE=SCSPRT), 
and 3790 full function (SESTYPE=USERPROG) logical units. 

For DFHTCT TYPE=LINE,TRMTYPE=TCAM, code CRLP 


• When the BMSDEV operand is omitted, support for all of the 
above devices is included by default. 

• When the BMSDEV operand is specified, device support is 
generated only for those devices specified. 
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• If MAP3270=YES and BMSDEV=3270 and all other parameters are 
specified as NO, or defaulted to NO, a special version of 
BMS is generated. This version of BMS supports 3270 
mapping only . 

• If the BMSDEV operand is specified with one or more of the 
above parameters (excluding 3650/3270 and 3270), MAPHC=YES 
must also be specified if mapping support is required for 
these non-3270 devices. 

• If BMS is generated with MAP3270=YES and MAPHC=YES, and the 
CICS/VS message switching transaction (CMSG) or the BMS 
copy command (to print messages on a 3275 printer, or on a 
3270 display with the printer-adapter feature) are 
required, line printer support must be generated by 
specifying the BMSPROP=YES operand. This specification is 
also required if logical messages are to be built for those 
printers which use NLEOM. 

• BCHLU is equivalent to specifying 3770B 

• INTLU, 3767, 37701 and SCS are synonyms in DFHSG 
PROGRAM=BMS. INTLU may be applied to both 3767 and 37701, 
which may also be specified separately with identical 
results. 

• If batch logical units are to be supported by BMS, the 
batch data interchange program (DFHSG PROGRAM=DIP) must be 
generated. 

• BMSDEV= 3270 includes 3270 with TCAM support, 3270 with VTAM 
support, and 3270 compatibility mode. 

• For TCAM SNA logical units, the BMSDEV operand should 
specify the unique device type for device-dependent 
mapping. 


BMSDIAG=MIN| NORMAL |EXTENDED 

indicates the degree of internal checking to be performed by 
BMS diagnostics. The default is NORMAL. 

MIN 

specifies generation of minimum error checking, a subset of 
error checking normally performed by BMS. Use of this 
option should be considered very carefully and then used 
only with stable and well tested application programs. 

This option deletes routines intended to detect errors and 
protect the online system and may be used to reduce virtual 
storage requirements and improve performance. 

It is essential that this option must not be used when 
testing new or changed application programs, or when 
investigating suspected errors in CICS/VS code. 

NORMAL 

specifies generation of all routines necessary to generate 
all documented return codes and transaction abends. 
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EXTENDED 

may be used to generate diagnostics, in the form of trace 
table entries, which may be useful when testing new or 
changed application programs or investigating suspected 
problems in BMS code. These traces are documented in the 
trace section of the appropriate CICS/VS Application 
Programmer*s Reference Manual. 


BMSDRT=YES|NO 

| specifies whether routines to process BMS return requests 

| should be generated. If NO is specified, DFHBMS TYPE=RETURN or 

I EXEC CICS SEND requests with the SET option are invalid. The 

default is YES. 


| BMSFMP=YES|NO 

indicates whether routines will be generated to accept 
parameters from DFHBMS macros for inclusion in the function 
management header to be sent to logical units that also have 
BMSFEAT=FMHPARM coded in the DFHTCT TYPE=TERMINAL macro 
instruction. The default is NO. 

YES 

indicates that specified routines will be generated. 

NO 

indicates that support for function management header 
parameters except for outboard formatting, which is 
controlled by the BMSOBF specification, will be deleted. 
| FMHPARM options of BMS are ignored, unless used for 

outboard formatting, if BMSFMP=NO is specified or 
defaulted. 


BMSFRL= YES I NO 

specifies whether routines to perform field relocation will be 
generated. These routines are needed if the size operand of 
DFHMDI macros specifies a map with less than the page width 
defined in the terminal entry. Field relocation is also used 
if the map origin, as specified by the line and column 
parameters of DFHMDI, is other than line one, column one. The 
default is YES. 

YES 

indicates that routines to perform field relocation will be 
generated. BMSFRL=YES is required if BMSPB=YES is coded or 
defaulted. 

NO 

indicates that routines to perform field relocation will be 
deleted. 


BMSMBD=YES|NO 

specifies whether BMS mapping routines for handling maps with 
DATA=BLOCK specified should be included. If NO is specified, 
maps and map sets that have DATA=BLOCK specified in DFHMSD or 
in DFHMDI macros are invalid. COMPAT=F2260 requires BMSMBD=YES 
to be specified or defaulted. The default is YES. 
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BMSNL=character 

specifies the character that represents the new-line (NL) 
character (end of a logical line) in all messages to and from a 
3270 terminal operating in FASTER 2260 compatibility mode 
(COMPAT=F2260). The character chosen has the same restrictions 
as for BMSSMI. The NL character also remains constant for the 
entire system- The default is BMSNL=< (X*4C*). 

Note : The former user of the FASTER program product will recognize the 

preceding two parameters as equivalent to the DFTERM parameters: SOM 
and NL. However, unlike the FASTER operating environment, the 
characters chosen remain constant for all terminals. If operating using 
the FASTER Language Facility, no modification is necessary to the data 
as formatted by the TPD (Transaction Processing Description). 


BMSOBF=NO|3270 

specifies whether support for outboard formatting is to be 
generated into BMS. This operand applies to logical units 
only. The default is NO. 

NO 

indicates that support for outboard formatting is not to be 
generated. 


3270 

specifies that support for outboard formatting for a 3270 
attached to a 3650 controller is to be generated into BMS. 
If this operand is not specified, BMS will not support 
outboard formatting even though the user has requested it 
with the map definition macro instructions. 

FOR BMSOBF=3270, MAP3270=YES must also be generated. 


BMSP3=YES|NO 

specifies whether BMS page building routines should be 
included. If NO is specified, DFHBMS=PAGEBLD and OFLOW=address 
requests are invalid. COMPAT=F2260 requires BMSPB=YES to be 
specified or defaulted. The default is YES. 


BMSPGO=YES|NO 

specifies whether BMS pageout routines should be included. If 
NO is specified, DFHBMS TYPE= PAGEOUT or EXEC CICS SEND PAGE 
requests are invalid. The default is YES. 

Pageout routines are not required if ROUTING=NO, PAGING=NO, 
BMSPB=NO, and BMSTXB=NO are all specified. COMPAT=F2260 
requires BMSPGO=YES to be generated or defaulted. 


BMSPRG=YES|NO 

specifies whether BMS purge routines should be included. If NO 
is specified, BMS purge operations requests are invalid. The 
default is YES. 

Purge routines are not required if ROUTING=NO, BMSPB=NO, 
BMSTXB=NO, and PAGING=NO have been specified, or if application 
programs never issue BMS purge requests. COMPAT=F2260 requires 
BMSPRG=YES to be specified or defaulted. 
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BMSPROP=NOI YES 

indicates whether the necessary printer support to handle NLEOM 
requests from 3270 printers will be generated. The default is 
NO. 

NO 

indicates that printer support is not required. 

YES 

indicates that 3270 printer support for NLEOM requests will 
be generated. If this option is specified, MAPHC=YES, 

MAP3270=YES , and BMSDEV=CRLP need not be specified. 


BMSRCVR=YES|NO 

specifies whether routines to participate in the recovery of 
routed or non-routed messages are to be generated. The default 
is NO. 

YES 

indicates that BMS routines to participate in the recovery 
of routed and non-routed messages will be generated. 
However, BMS recovery requires recovery in the interval 
control program and temporary storage program, and in all 
modules which support them. 

NO 

indicates that all BMS routines which participate in the 
recovery of routed and non-routed messages are to be 
deleted. BMS will still honor and use the REQID 
specifications specified by the user because this does not 
necessarily imply recovery. 


BMSSMI=character 

specifies the character which represents the start-of-message 
indicator (SMI) in all messages to and from a 3270 terminal 
operating in FASTER 2260 compatibility mode (COMPAT=F2260). 

The character chosen must be a valid alphameric character 
(excluding the following: * = , 6 and blank) and must be 
present on the 3270 keyboard. If the SMI is contained in an 
output data stream, its display is dependent upon the language 
feature specified for the 3270 terminal. Whichever character 
is chosen remains constant for the entire system. The default 
is BMSSMI=~- (X 1 * 4A f ) • 


specifies whether tab support is required. If NO is specified 
or defaulted, the parameters HTAB=(tab,...) and VTAB=(tab,...) 
in the DFHMSD application programming macro instruction cannot 
be used; the specification of VTAB and HTAB will cause the 
transaction to be abnormally terminated, and the DFHMSD map 
definition will be ignored. The default is BMSTAB=NO. 

BMSTAB may be specified for TCAM supported devices if 
ACCMETH=TCAM and TRMTYPE=TCAM are specified in DFHTCT 
TYPE=LINE. 


BMSTXB=YES|NO 

| specifies whether BMS text building routines should be 

| included. If NO is specified, BMS text building requests and 

the following operands are invalid: HEADER, TRAILER, and 
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JUSTIFY. The default is YES. BMSTXB=YES must be specified or 
allowed to default if message switching support is required. 


COMPAT—PRE—VSJ F2260 

specifies whether either of the compatibility features is to be 
generated. 

PRE-VS 

indicates that the user intends to use maps that have not 
been recompiled or reassembled under CICS/VS. MAP3270=YES 
must be specified for COMPAT=PRE-VS. 

Note : Pre-VS application programs must be re-assembled. 


F2260 

indicates that the user intends to operate non-VTAM 3270 
terminals in FASTER 2260 compatibility mode. COMPAT=F2260 
requires MAP3270=YES, MAPHC=YES, BMSMBD=YES, BMSPB=YES r 
BMSPGO=YES, and PAGING=YES. 


DUMMY=YES 

specifies that a dummy BMS program is to be generated. 

This operand may be used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy basic mapping support program. 
Any other operands which may have been included in the DFHSG 
PROGRAM=BMS macro instruction are ignored. 


MAP32 7 0=YES|NO 

specifies whether BMS will support the 3270 Information Display 
System. MAP3270=YES or BMSDEV=3270 is required for BMS support 
of the 3270. The default is MAP3270=YES. 

YES 

indicates that support for the 3270 will be generated. 

NO 

indicates that support for the 3270 will not be generated. 


MAPALGN=YES|NO 

specifies whether BMS will support halfword-aligned or 
unaligned length fields in input maps (that is, those generated 
using the DFHMSD macro with MODE=IN or INOUT). The default is 
MAPALGN=NO. 

YES 

indicates that BMS will expect the length fields in input 
maps to be halfword-aligned. For the required changes to 
the JCL, see the appropriate CICS/VS System Programmers 
Guide. 


indicates that BMS will not expect the length fields in 
input maps to be aligned. 
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MAPHC=NO | YES 

specifies whether the BMS hard copy mapping function for 
printout is required for the following devices: 

1050, 2740, 2741, 2770, 2780, 2980 (keyboard and printer only) 

| 3270 devices with the printer-adapter feature when new-line- 

character support is required, 

3601, 3650UP, 3653, 3780, TAPE, DASD, TWX, CRLP, DISK, and 
TRMTYPE=TCAM terminals (see the DFHTCT TYPE=LINE macro 
instruction). 


I 

I 


I 


I 


The default is MAPHC-NO. 

NO 

indicates that the BMS hard copy mapping function will not 
be supported for these devices. 

YES 

indicates that the BMS hard copy mapping function will be 
supported for these devices. 

Notes : 

1. If BMS is generated with MAP3270=YES and MAPHC=NO, and a 
logical message is built for a 3270 printer, or for a 3270 
display with the printer-adapter feature using BMS requests 
which specify the PRINT option, the contents of the entire 
3270 buffer will be printed, regardless of the length of 
the message. 

2. The BMSDEV= operand must be specified if: 

BMS is generated with MAP3270=YES and MAPHC=YES, and 
the CICS/VS message switching transaction (CMSG), or 
the BMS copy command to print messages on a 3270 
printer or on a 3270 display with the printer-adapter 
feature, are required, and/or 

if building of logical messages for these printers 
using the NLEOM option of the BMS macro is required. 

Alternatively, the BMSPROP=YES option may be used 
instead of MAP3270=YES, MAPHC=YES, and BMSDEV=CRLP. 

See also the notes under the BMSDEV operand. 


PAGING=NO|YES 

specifies whether pages can be stored on temporary storage 
prior to their retrieval. In order to use paging, temporary 
storage support is required. The default is PAGING=NO. If 
PAGING=YES is specified, AUTOTRN= YES must be specified in DFHSG 
PROGRAM=TCP. 

NO 

indicates that paging will not be supported. 

YES 

indicates that paging will be supported. 
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PRGDLAY=hhmm 

indicates the purge delay time interval that is added to the 
specified delivery time to determine when a message is to be 
considered undeliverable and therefore purged- This time 
interval is specified in the form "hhmm" (where "hh" represents 
hours from 00 to 99 and "mm” represents minutes from 00 to 59). 
If PRGDLAY is not specified, a message will remain eligible for 
delivery either until it is purged or until temporary storage 
is reinitialized. The PRGDLAY facility requires ROUTING=YES 
and PAGING-YES to be generated. 

| Note that the PRGDLAY value determines the interval between 

| terminal page clean-up operations. A very low or zero value 

will prevent other tasks from executing. The actual purge 
delay time interval specified is dependent on individual system 
requirements. 


NO|YES 

indicates whether messages can be routed to a destination other 
than the originating terminal and/or to multiple destinations. 
The default is ROUTING=NO. If ROUTING=YES is specified and the 
user wants to put messages to temporary storage (see DFHBMS 
TYPE=STORE or the PAGING option in the appropriate CICS/VS 
Application Programmers Reference Manual ), the user must also 
specify PAGING=YES. The BMS macro forces PAGING=YES if 
ROUTING=YES is specified. If ROUTING=YES is specified, 

AUTOTRN= YES must be specified in DFHSG PROGRAM=TCP. 

NO 

indicates that routing will not be supported. 

YES 

indicates that routing will be supported. 


SKR32 70=NO|YES 

specifies whether single keystroke retrieval is required. The 
default is NO. 

SKR3270=YES requires that MAP3270=YES and PAGING=YES are also 
specified or defaulted. If not specified, they are forced to 
YES and the user is informed. 


ROUTING= 


I 

I 


SUFFIX=xx 

provides a one- or two-character suffix (other than NO or DY 
which are reserved) for the set of basic mapping support 
programs being generated. This suffix is appended to all 
programs generated except DFHBMSMM, DFHTPQ, DFHTPR, and DFHTPS. 
If this operand is omitted, a suffix is not provided. 


CSA — COMMON SYSTEM AREA 


The system generation macro instruction necessary to generate the common 
system area is DFHSG PROGRAM=CSA. 

| The size of the CSA work area (CWA) may also be specified in the 
| WRKAREA operand of DFHSIT, or by means of the WRKAREA operator override 
| parameter. 
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In addition to generating the CSA, the execution of this macro 
instruction causes the assembly of terminal control's TCA, task 
control"s TCA f and, in CICS/DOS/VS, a write-to-operator (WTO) routine. 

| Note : Stage 2 jobs will always be produced for DFHSG PROGRAM= CSA• 


r — -- r - - - r - 

| jDFHSG j PROGRAM^CSA 

| j j (,DATFORM= C mmddyv lddmmyy|yymmdd)] 

| | j [ ,SUFFIX=xx3 

| j | [,WRKAREA={512|number}] 

L_L-L_ 


I 

I 

I 

I 


PRO GRAM=C SA 

indicates that the common system area is to be generated. 


DATFORM=format-of-date-display 

specifies the external date display standard that is required 
by the user. An appropriate indicator setting is made in the 
CSA. This is examined by CICS/VS-supplied system service 
programs that display a Gregorian date. As part of their 
operation, the indicator can also be examined by customer- 
written programs. It is the user"s responsibility to supply 
his own Gregorian date conversion routine, because CICS/VS 
maintains the date in the form "YYDDD" in the CSA. The default 
is DATFORM=mmddyy. 

mmddyy 

indicates that the date will be in the form of 
month/day/year. 

ddmmyy 

indicates that the date will be in the form of 
day/month/year. 

yymmdd 

indicates that the date will be in the form of 
year/month/day. 


WRKAREA=512|number 

specifies the number of bytes to be allocated to the common 
work area of the CSA. This area is initially set to binary 
zeros and is available to all programs. The maximum size for 
the work area is 3584 bytes; the default is WRKAREA= 512. 


SUFFIX=xx 

provides a one- or two-character suffix for the CSA being 
generated. If this operand is omitted, a suffix is not 
provided. 


CSD — CONTROL SYSTEM DUMMY GROUP 


| If a particular CICS/VS management program (for example, the file 
j control program) is not required, the user need not generate that 
j program and, as a result, can save the amount of virtual storage that 
would be required to contain the program. However, a dummy program must 
be provided for every CICS/VS management program not actually generated. 
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If the control system dummy group is generated in response to the 
DFHSG PROGRAM=CSD macro instruction, dummy programs with the suffix "DY" 
are produced for the following programs: 

• File control program 

• Trace control program 

• Batch data interchange program 

• Transient data control program 

• Dump control program 

• Temporary storage control program 

• System recovery program 

• Basic mapping support program 

• Journal control program 

• Built-In functions program 

• Keypoint program 

This facility allows all of the above dummy programs to be generated 
without generating each one separately. 


\ [dFHSG \ PROGRAM^C SD 

| | I [,STAGE2={SELECTIVE|FORCE}] 


'1 

I 

I 


J 


PROGRAM=CSD 

indicates that the control system dummy group is to be 
generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE= INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 


CSO — CONTROL SYSTEM OPERATIONAL GROUP 


The system generation macro instruction necessary to generate the 
control system operational group is DFHSG PROGRAM=CSO. The following 
modules are generated in response to this macro instruction: 

• System initialization program (DFHSIP) and its overlays 


Chapter 2.2. DFHSG PROGRAM=CSO 


37 






System termination program (DFHSTP) 

Abnormal condition program (DFHACP) 

Console write-to-operator program (DFHCWTO) - DOS/VS only 
Terminal abnormal condition program (DFHTACP) 

LIFO storage program (DFHLFO) 

Error message program (DFHMGP) 

Error message table (DFHMGT) 

Intersystem communication link statistics program (DFHSTLK) 

A dummy terminal error program (DFHTEP). A sample DFHTEP is also 
provided, (See "Generating the Sample Terminal Error Program" in 
Chapter 4.2.) 

Time adjustment program (DFHTAJP) 

File and terminal statistics program (DFHSTTR) 

Supervisor statistics programs (DFHSTKC) 

Formatted dump program (DFHFDP) and its subprograms. Note that if 
a SNAP dump is not required for transaction ASRA or ASRB abends 
when FDP=SNAP or FULL is specified in DFHSIT, the two assembler 
comment lines at label FDASNAP in this module should be replaced by 
the code as noted in the comment, before running the CICS/VS system 
generation. This applies to CICS/OS/VS only. 

Automatic statistics summarization control program (DFHSTSP) 

Data management statistics program (DFHSTTD) 

Program and dump statistics program (DFHSTPD) 

7770 read/write program (DFHRWP70) - CICS/OS/VS only, and only if 
the SVC and CAA operands are specified 

7770 channel/abnormal end appendage program (IGG019zz where 
zz=appendage suffix) - CICS/OS/VS only, and only if the SVC and CAA 
operands are specified 

7770 SVC program (IGCOOxxx) - CICS/OS/VS only, and only if the SVC 
and CAA operands are specified. 

DL/I interface program (DFHDLI) - CICS/OS/VS only, and only if 
DLl=l.0.1 or DL1=1.1.0 was specified in the DFHSG TYPE=INITIAL 
macro instruction 

DL/I interface dummy program (DFHDLIDY) - CICS/OS/VS only 

DL/I application program (DFHDLQ) - CICS/OS/VS only, and only if 
DL1=1.0.1, DL1=1.0.4, or DL1=1.1.0 was specified in the DFHSG 
TYPE=INITIAL macro instruction 

A dummy program error program (DFHPEP) 
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• Message switching program (DFHMSP) - To use this, basic mapping 
support must be generated with ROUTING=YES, PAGING=YES, and f if 
3270 terminals are involved, MAP3270=YES, BMSPGO=YES, and 
BMSTX3=YES. Refer to the notes under the BMSDEV= and MAPHC= 
operands of DFHSG PROGRAM=BMS. In addition, temporary storage is 
required. 

• Direct Access Logic Module CDFHSDAM) - DOS/VS only 

Note : To bypass the automatic statistics program normally generated by 

DFHSG PROGRAM=CSO, the following program may be assembled and linked to 
the CICS/VS relocatable library to replace the DFHSTSP module generated 
during system generation. 

DFHCOVER 
COPY DFHCSADS 
COPY DFHTCADS 
OPFLREG EQU 10 

RC11 EQU X*11 1 

DFHSTSP CSECT 

USING CSAOPFL,OPFLREG 
L OPFLREG,CSAOPFLA 

MVI CSASTSRC,RCll 
DFHPC TYPE=RETURN 
END 

When using this program, only the PPT entry for DFHSTSP is required? 
automatic statistics table entries for DCT and PCT are not required. 

The following message will be printed if an attempt is made to 
communicate with the program: 


OPTIONAL FEATURES LIST BASE 
RETURN CODE - NO AUTO STATS SUPPORT 


LOAD OPTIONAL FEATURES LIST ADDRESS 
INDICATE NO AUTOMATIC STATISTICS 
DFHSTKC WILL ISSUE MESSAGE 



DFH1822 

AUTOMATIC STATISTICS NOT SUPPORTED 


r 

|DFHSG 

1 

1 

[ PROGRAM=CSO 

| [ ,STAGE2= { SELECTIVE | FORCE}J 

i 

-L -- - "“"H 


1 

i 

1 

I 

1 For DOS/VS Only 

1 



1 

i 

1 

1 

| [ ,NSD= {91 number >] 

i 



1 

i 

1 

1 For OS/VS Only 



i 

i 

i 

i 

i 

i 

| [,CAA=appendage-suffix] 
j [,SVC={200|number>] 

| [ ,TCAMSIP=YES ] 

j [,V1CMPAT=YES] 

- L_ _ __ ____ ____ 

. _ _1 


PROGRAMS SO 

indicates that the control system operational group is being 
generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 
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FORCE 

forces generation of all Stage 2 jobs for this program. 

In CICS/DOS/VS, the Stage 2 job for DFHSIP, DFHPEP, and DFHTEP 
will always be produced. For CICS/VS under 0S/VS1, Stage 2 
jobs will always be produced for the following programs; 


DFHSIB1 

DFHSIEl 

DFHSIF1 

DFHSIH1 

DFHSTP 

DFHTACP 


DFHTEP 

DFHSTTR 

DFHSTSP 

DFHDLI 

DFHDLQ 


For CICS/VS under 0S/VS2, Stage 2 jobs will always be produced 
for the following programs: 


DFHSIP 

DFHSIB1 

DFHSIC1 

DFHSIDl 

DFHSIEl 

DFHSIF1 

DFHSIH1 

DFHSTP 


DFHTACP 

DFHTEP 

DFHSTTR 

DFHSTSP 

DFHDLI 

DFHDLQ 

DFHCAA70 

DFHDEB70 


For 0S/VS2 Release 3.7 (MVS) with the performance shippable 
units (5 and 7), if service request block (SRB) processing is 
generated. Stage 2 jobs are always produced for DFHSIJ1 and 
DFHFDP. 


For CICS/DOS/VS only 


NSD=number 

specifies the maximum number of nonsequential disk extents that 
will exist for any data set involved in the execution of 
CICS/DOS/VS. CICS/VS system generation uses this value to 
determine the amount of storage to be reserved at the beginning 
of the partition for label processing when the data sets are 
opened. Although most data sets are opened during system 
initialization, the dynamic open/close feature of the CICS/VS 
master terminal program may require the use of this label 
processing area at any time during CICS/VS execution. The 
presence of this operand makes it unnecessary for the user to 
supply a DOS/VS LBLTYP job control statement with the CICS/VS 
execution deck. The minimum value that can be specified is 1. 

I Note : The NSD operand can also be specified in the DFHSIT 

| macro or as a system start-up override. 
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For ClCS/OS/VS only 


CAA=appendage-suffix 

specifies the two-character alphanumeric suffix to be assigned 
to the 7770 channel end/abnormal end appendage routine provided 
by CICS/VS when that routine is link-edited to SYSl.SVCLIB in 
VS1 or SYS1•LPALIB in VS2. The suffix specified must be in the 
range WA to Z9. This operand is required if the ACCMETH=BTAM 
and BTAMDEV=7770 operands are included in the DFHSG PROGRAM^TCP 
macro instruction, and if the APPENDG operand is included in 
the DFHTCT TYPE=SDSCI macro instruction. For information on 
adding appendages to the operating system, see OS/VS1 Data 
Management for System Programmers or OS/VS2 System Program 
Library; Data Management . 


SVC=number 

specifies the SVC number under which the 7770 SVC routine 
provided by CICS/VS is to be link-edited to SYSl.SVCLIB in VS1 
or SYS1.LPALIB in VS2. The number specified must be in the 
range 200 to 255. The default is SVC=200 for system generation 
purposes; however, the SVC will not be link-edited unless it is 
given an explicit value. This operand is required if the 
ACCMETH=BTAM and BTAMDEV=7770 operands are included in the 
DFHSG PROGRAM=TCP macro instruction. For information on adding 
SVC routines to the operating system, see the OS/VS1 Planning 
and Use Guide or the OS/VS2 Planning and Use Guide . 


TCAMSIP= YES 

generates TCAM support in the system initialization program. 


VICMPAT—YES 

must be specified if the user wishes to have the terminal 
abnormal condition program (DFHTACP) provide a CICS/OS Version 
1 interface when linking to the user-written terminal error 
program (DFHTEP) under CICS/OS/VS. This operand is to be used 
only by those former CICS/OS Version 1 users who have an 
existing DFHTEP. 


CSS 


CONTROL SYSTEM SERVICE GROUP 


i 

S 


The system generation macro instruction necessary to generate the 
control system service group is DFHSG PROGRAM=CSS. The programs 
generated by this macro instruction are as follows: 

• Sign-On program (DFHSNP) 

• Sign-Off program (DFHSFP) 

• F.E. terminal test program (DFHFEP) 


f IDFHSG [ PROGRAM=CSS 

j j | C,STAGE2={SELECTIVE|FORCE}] 


“1 

i 

i 

j 
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PROGRAM=CSS 

indicates that the control system service group is to be 
generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 


CSU — CONTROL SYSTEM UTILITY GROUP 


The system generation macro instruction necessary to generate the 
control system utility group is DFHSG PROGRAM=CSU. The dump utility 
program (DFHDUP), automatic statistics summarization utility program 
(DFHSTUP), and trace utility program (DFHTUP) are generated in response 
to this macro instruction. 

r-r-r-"- 1 

| (DFHSG | PROGRAM=C SU | 

I | | C ,STAGE2={SELECTIVE|FORCE!3 | 


PROGRAMS SU 

indicates that the control system utility group is to be 
generated. Support for all device types is generated in this 
program. Specific device types may be selected at execution 
time. For further details, refer to the CICS/VS System 
Programmer w s Guide (DOS/VS). 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 


DBP — DYNAMIC TRANSACTION BACKQUT PROGRAM 

The function of the dynamic transaction backout program is to backout 
the effects of a single in-flight transaction which terminates 
abnormally, and restore protected resources, which had been altered by 
the transaction which failed, to the state they were in before the 
transaction started. This feature operates while the rest of the 
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CICS/VS system is functioning normally, and not, as in the case of the 
transaction backout program, when emergency restart is invoked when 
CICS/VS is unable to effect its normal termination process. 

The system generation macro instruction necessary to generate the 
| dynamic transaction backout program is DFHSG PROGRAM=DBP. The CICS/VS- 
j supplied version of DFHRTY for the transaction restart facility is also 
| generated in response to this macro instruction. 


f [dFHSG [ PROGRAM=DBP ] 


j j j t,STAGE2={SELECTIVE|FORCE}3 j 
| | | [,SUFFIX=Xx3 j 
j | j [,XDERROR=symbolic-name] | 
j j | [,XFERROR=symbolic-name] j 
j j | [,XINIT=symbolic-name] | 
| | j [,XINPUT=symbolic-name] j 
l-l_l _j 


PROGRAM=DBP 

indicates that the dynamic transaction backout program is to be 
generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

| Note ; In CICS/OS/VS, Stage 2 jobs will always be produced for 

| these programs. 


SUFFIX=xx 

is used to provide a unique one- or two-character alphameric 
suffix that identifies the dynamic transaction backout program 
being generated. If this operand is omitted a suffix is not 
provided. 


XDERROR=symbolic-name 

is used to generate linkage to a user-written exit routine when 
an error condition is encountered while attempting DL/I data 
base backout. 


XFERROR=symbolic-name 

is used to generate linkage to a user-written exit routine when 
an error is detected while attempting file backout. 


XINIT=symbolic-name 

is used to generate linkage to a user-written exit routine in 
the initalization phase of DFHDBP• 
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XINPUT=symbolic-name 

is used to generate linkage to a user-written exit routine 
after a record has been read from the dynamic log. 


DCP — DUMP CONTROL PROGRAM 

The system generation macro instruction necessary to generate the dump 
control program is DFHSG PROGRAM=DCP• 



PROGRAM=DCP 
[,CICSDMP={NO|YES}] 

[,DUMMY=YESl 

C,STAGE2={SELECTIVE|FORCE >] 

C,SUFFIX=xx] 

For DOS/VS Only 

[, DEVADDR={010|nnn}] 

[,DEVICE={TAPE|2314|3330|3340|3350}] 


PROGRAM=DCP 

indicates that the dump control program is to be generated. 


CICSDMP=NO|YES 

specifies whether the optional feature of dumping CICS/VS 
tables is to be generated. The default is CICSDMP=NO. 

NO 

indicates that support for dumping CICS/VS tables is not to 
be included. 

YES 

indicates that support for dumping CICS/VS tables is to be 
included. 


DUMMY=YES 

specifies that a dummy dump control program is to be generated. 
This operand may be used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy dump control program. Any 
other operands which may have been included in the DFHSG 
PROGRAM=DCP macro instruction are ignored. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : In CICS/DOS/VS, Stage 2 jobs will always be produced for 

this program. 
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SUFFIX=xx 


provides a one- or two-character alphameric suffix (other than 
NO or DY which are reserved) for the dump control program being 
assembled. If this operand is omitted, a suffix is not 
provided. 


For CICS/DOS/VS only 


DEVADDR=nnn 

specifies, for DEVICE=TAPE only, the DOS/VS device address to 
be assigned to the tape drive. It should be a three-digit 
decimal number with leading zeros, if necessary. For example, 
if SYS008 is the device address to be used, DEVADDR= 008 must be 
specified. The default is DEVADDR=010. If the DEVICE=2314, 
3330, 3340, or 3350 operand is used, the DEVADDR value is 
picked up from the label information supplied for the dump 
control data set. 


DEVICE=device 

specifies the type of output device. A particular dump control 
program in CICS/DOS/VS will support only one type of output 
device. If different device types are required on different 
runs, more than one dump control program must be generated 
using the SUFFIX=xx operand. The default is TAPE unless 
overriden by the DEVICE operand of DFHSG TYPE=INITIAL. 


DIP — BATCH DATA INTERCHANGE PROGRAM 


The batch data interchange program supports data communication between 
application programs running under CICS/VS and logical units such as the 
3770 and 3790 batch data interchange logical units. 

In addition, the batch data interchange program provides data 
management functions used with the 3790 batch controller function and 
the 3770 batch data interchange logical unit. 

The batch data interchange program must also be generated when a 
batch logical unit requires BMS features. 

The system generation macro instruction necessary to generate the 
batch data interchange program is DFHSG PROGRAM=DIP. 


r- r - r - 

| |DFHSG j PROGRAMS DIP 

j | | C,DUMMY=YES] 

| | j C,STAGE2={SELECTIVE|FORCE)] 

j j | C,SUFFIX=xx3 


'1 


I 

I 

J 


PROGRAM= DIP 

indicates that the batch data interchange program is to be 
generated. 
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DUMMY=YES 


indicates that a dummy batch data interchange program is to be 
generated. This operand is used instead of the DFHSG 
PROGRAM=CSD macro instruction to generate a dummy batch data 
interchange program. Any other operands which may have been 
included in the DFHSG PROGRAM=DIP macro instruction are 
ignored. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 


SUFFIX=xx 

is used to provide a unique one- or two-character alphameric 
suffix which identifies the batch data interchange program 
being generated. If this operand is omitted a suffix is not 
provided. 


EIP — EXEC INTERFACE PROGRAM 


The system generation macro instruction DFHSG PROGRAM=EIP generates an 
EXEC interface program which supports the functions that may be accessed 
via the application programmer's command interface. Installations whose 
application programs use the command interface to CICS/VS will also need 
to specify the command (EXEC) language translator program. See DFHSG 
PROGRAM=EXP, below. 

| A list of the modules generated by DFHSG PROGRAMMEIP can be found in 
| Appendix C. 


r - r - r - ,, 

| IDFHSG j PROGRAMMEIP | 
| | | C,STAGE2={SELECTIVE|FORCE}] | 
t_ L _l_i 


PROGRAMMEIP 

indicates that the EXEC interface program is to be generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 
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FORCE 

forces generation of all Stage 2 jobs for this program. 


EXP COMMAND (EXEC) LANGUAGE TRANSLATOR PROGRAM 


The system generation macro instruction necessary to generate a 
| translator for the command interface to application programs written in 
| PL/I, COBOL, Assembler, or RPG II is DFHSG PROGRAM=EXP. Installations 
whose application programs use the command interface to CICS/VS will 
also need to specify DFHSG PROGRAM=EIP. For further details, refer to 
the CICS/VS System Programmer's Guide and to the installation manuals 
for the appropriate compilers. 

| Note that DFHSG PROGRAM^HLL need not be generated if the macro 
interface to CICS/VS is not being used. 

The modules generated by the DFHSG PROGRAM=EXP macro instruction are: 
For LANG=C0B0L 

• DFHECP - translator 
For LANG=PL/I 

• DFHEPP - translator 
| For LANG=ASM 

| • DFHEAP - translator 

| For LANG=RPG (CICS/DOS/VS only) 

| • DFHERP - translator 

j In CICS/0S/VS, the application interface stubs (DFHEAI, DFHEAIO, 

| DFHECI, and DFHEPI) are also generated by this macro. 


r - r - r - 1 



|DFHSG 

1 

1 

1 

J 

| PROGRAM=EXP 

j f LANG=[(COBOL,PLI,ASM,RPG)]|{COBOL|PLI|ASM|RPG} 
j t,STAGE2={SELECTIVE|FORCE}] 

| [,SUFFIX=xx] 

■ 



1 

1 

1 

1 For CICS/OS/VS only 



1 

1 

1 

1 

| t, {PLI|PLI}=SHARE] 
j t,PLILIB=dataset-name] 



|| | g JJ4.UJ.JJ V4U WUOV, U 11UU1U J « | 

L -L-L-J 


PR0GRAM=EXP 

indicates that the command language translator program is to be 
generated. 
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LANG=language 

specifies the language(s) for which a translator is 
If LANG=PLI is specified, the PL/I DOS Version 5 or 
Version 3 compiler and libraries must be installed, 
include installing the DFHPL10I (OS/VS), and DFHSAP 
(DOS/VS) modules supplied by PL/I, instead of those 
CICS/VS. 


required. 
PL/I OS 
This will 
and DFHPLlI 
supplied by 


i 


Notes: 


I 


1. PLI may also be written as PLl, PL/1, or PL/I. 


I 


2. RPG II may only be used with CICS/DOS/VS. 


I 

I 


3. Any combination of COBOL, PL/I, ASM, RPG may be written, 
with the languages separated by commas and with the list 
enclosed within parentheses. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 


SUFFIX=xx 

provides a one- or two-character alphameric suffix for the set 
of command translator programs being generated. If this 
operand is omitted a suffix is not provided. 


For CICS/OS/VS only 


| PLl|PLI=SHARE 

indicates that support for the PL/I shared library facility is 
to be generated. 


PLILIB=dataset-name 

specifies the name of the data set containing the PL/I base 
library. This operand is only applicable when PLI=SHARE is 
specified. The default data set name is SYSl.PLIBASE. 


FCP — FILE CONTROL PROGRAM 


The system generation macro instruction necessary to generate the file 
control programs is DFHSG PROGRAM=FCP. The following modules are 
generated when this macro is specified: 
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• DFHFCP - which contains VSAM code and common subroutines, and will 

| be accessed from the CSA. Note that, for OS/VS2 Release 3.7 (MVS) 

| with shippable units 5 and 7, DFHFCP will contain support for VSAM 

fast path (ICIP files) if SRBSVC=number is specified in DFHSG 
TYPE=INITIAL. For CICS/DOS/VS, DFHFCP also contains DAM and ISAM 
code. 

• DFHFCD (CICS/OS/VS only) - which contains the ISAM and BDAM code. 
DFHFCD will link back to the primary module (DFHFCP) to use the 
common subroutines. 

I Note : Stage 2 jobs will always be produced for DFHFCP and DFHFCD. 

Unless otherwise indicated, the omission of an operand results in the 
corresponding function not being included. 



|DFHSG 

j PROGRAM= FCP 



1 

1 

1 

1 

| ,FILSERV=(service[,service],...) 

| f,AUTOJRN={NO1 YES >] 
j l,DUMMY=YES] 
j [,SUFFIX=xx] 



1 

1 

1 

1 

| (,XINPUT=symbolic-name] 

| (,XINPUTC=symbolic-name] 

| [,XOUTPUT=symbolic-name] 

| (,XTYPREQ=symbolie-name] 



PROGRAM=FCP 

indicates that the file control programs are to be generated. 


FILSERV=srevice 

specifies which of the file services are to be generated into 
the file control programs. The applicable keyword parameters 
are as follows: 


INDA 

Input DAM 

DAUPD 

DAM Update 

DAADD 

DAM Add 

DBROWSE 

DAM sequential record retrieval 

HEXAD 

Hexadecimal relative track addressing 

DECAD 

Zoned decimal relative track addressing (DAM) 

ACTAD 

Actual track addressing (DAM) 

DABLKNG 

Direct access deblocking 

INIS 

Input ISAM 

ISUPD 

ISAM Update 

ISADD 

ISAM Add 

IBROWSE 

ISAM sequential record retrieval 

IVBR 

ISAM variable-length records (DOS/VS only) 

INVS 

Input VSAM 

VSUPD 

VSAM Update 

VS ADD 

VSAM Add 

VBR0WSE 

VSAM sequential record retrieval 

VDELETE 

VSAM Delete 

INDIRACC 

Indirect accessing 

EXCTL 

Exclusive control 

VLR 

Variable-length records 

LOCATE 

Dynamic OPEN/CLOSE/LOCATE 

INSEG 

Input segmenting 

OUTSEG 

Output segmenting 
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Any number of these keyword parameters can be included in the 
FILSERV operand. 

Notes ; 

1. Use of the DAM file browse option under CICS/OS/VS using 

actual addressing (FILSERV=DBROWSE and ACTAD) requires that 
the user copy the CVT macro instruction and place it in 
SYS1.MACLIB. For guidance on copying the CVT macro 
instruction, see QS/VSl Data Management for System 
Programmers or 0S/VS2 System Program Library: Data 

Management . 

2. LOCATE must be specified when DFHOCP is generated and for 
DL/I under CICS/OS/VS. 

3. LOCATE must be specified if the master terminal facility is 
used to access data bases. 

4. If the Browse function is used with unblocked instead of 
blocked ISAM files, considerable performance degradation is 
likely to occur. 

5. LOCATE must be specified if AUTOJRN=YES is specified or if 
data base backout is to be supported for specific files 
defined in the file control table (DFHFCT TYPE=DATASET, 

LOG=YES). 

6. INVS, VSUPD, VSADD, VBROWSE and VDELETE are not valid if 
VSAM=NO is specified in the DFHSG TYPE=INITIAL macro. 


AUTOJRN=YES|NO 

specifies whether automatic journaling of file accesses is to 
be supported. To obtain automatic journaling, AUTOJRN=YES must 
be specified in the generation of the journal control program 
as well as in the file control program. The default is 
AUTOJRN=NO. AUTOJRN=YES must be specified if the CICS/VS 
emergency restart or dynamic transaction backout functions are 
to be used. 

YES 

indicates that automatic journaling is required. 

NO 

indicates that automatic journaling is not supported. 


DUMMY=YES 

specifies that dummy file control programs are to be generated. 

This operand is used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate dummy file control programs. Any other 
operands which may have been included in the DFHSG PROGRAM=FCP 
macro instruction are ignored. 


SUFFIX=XX 

provides a one- or two-character alphameric suffix (other than 
NO or DY which are reserved) for the pair of file control 
programs being assembled. If this operand is omitted, a suffix 
is not provided. 
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XINPUT=symbolic-name 

generates linkage in the file control programs to a user- 
written exit routine. The linkage is provided after the file 
control table (FCT) is searched in response to an input 
request. For further information concerning user exits, see 
"User Exits for CICS/VS Management Programs" in Chapter 6.2 of 
this manual. 


XINPUTC=symbolic-name 

generates linkage in the file control programs to a user- 
written exit routine. The linkage is provided upon completion 
of an input event, but prior to deblocking requested input 
records. For further information concerning user exits, see 
"User Exits for CICS/VS Management Programs." 


XOUTPUT=symbolic-name 

generates linkage in the file control programs to a user- 
written exit routine. The linkage is provided prior to writing 
data in response to an output request. For further information 
concerning user exits, see "User Exits for CICS/VS Management 
Programs." 


XTYPREQ= s ymbolic-name 

generates linkage in the file control program to a user-written 
exit routine. The linkage is provided prior to determining 
what type of request for file services was issued. For further 
information concerning user exits, see "User Exits for CICS/VS 
Management Programs." 


GAP — GRAPHIC ATTENTION PROGRAM 


The system generation macro instruction necessary to generate the 
graphic attention program is DFHSG PROGRAM=GAP. This macro instruction 
must be issued only if support for local 2260 is to be generated. This 
macro applies to CICS/OS/VS only, and is not required under TCAM. 

r- r - r - 1 

j jDFHSG | PROGRAM=GAP | 

j | j [,STAGE2={SELECTIVE|FORCE>] j 


PROGRAM=GAP 

specifies support for local 2260 using CICS/OS/VS. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program- 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 
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HLL 


HIGH-LEVEL LANGUAGE SUPPORT GROUP 


The high-level language support group allows the COBOL or PL/I 
application programmer to use the macro interface to CICS/VS. If 
application programs use only the command interface to CICS/VS, the 
high-level language support group is not required. For details of the 
command interface to CICS/VS, see DFHSG PROGRAM=EIP and DFHSG 
PROGRAM=EXP earlier in this chapter. The system generation macro 
instruction necessary to generate the high-level language support group 
is DFHSG PROGRAM=HLL. 

The support programs generated in response to this macro instruction 
are as follows: 

• CICS/VS preprocessor program (DFHPRPR) - for either or both 
languages 

• Entry interface program (DFHPL1I) for PL/I F and/or (DFHPLlOI) for 
PL/I optimizer (OS/VS only) 

• PL/I storage allocation program (DFHSAP) for PL/I F and PL/I 
optimizer 

• Shared library transfer vector (PLISHRE), to interface between PL/I 
optimizer code and its shared library modules COS/VS only) 

Note : DOS/VS users should ignore any DFHPRPR assembly errors that occur 

if the tape macros DTFMT and MTMOD have been deleted from the source 
statement library. 


r-r-r- 1 



|DFHSG 

1 

PROGRAM= HLL 



1 

1 

1 

1 

1 

I 

[.LANG= C COBOL.PLI)IC COBOLIPLI}] 

[,STAGE2={SELECTIVE|FORCE >] 



1 

1 

1 

1 

For OS/VS Only 



1 

1 

1 

1 

1 

1 

[,PLIIF][,Ol(,SHARE]] 
t , PLILIB=dataset-name] 



t-L-t_J 


PROGRAM=HLL 

indicates that the high-level language support group is to be 
generated. 


LANG=language 

identifies the languages for which support is to be generated. 
The default is LANG=(COBOL,PLI). 

COBOL 

indicates ANS COBOL support. 


PLI 

indicates PL/I support. Note that this option can also be 
written as: PL/I, PLI, or PL/1. 
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STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 


For CICS/OS/VS only 


PL1|PLI|PL/I=compiler 

identifies the PL/I compilers for which support is to be 
generated. The default is PLI=F. 

F 

indicates the PL/I F-level compiler. 

O 

indicates the PL/I optimizing compiler. 

SHARE 

indicates that support for the PL/I shared library facility 
is to be generated. This is only available with the PL/I 
optimizing compiler. 


PLILIB=dataset-name 

specifies the name of the data set containing the PL/I base 
library. This operand is only applicable with the SHARE option 
of the PLI operand. The default data set name is SYS1.PLIBASE. 


ICP — INTERVAL CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
interval control program is DFHSG PROGRAMSCP. Unless otherwise 
indicated, the omission of an operand results in the corresponding 
function not being included. 

| If interval control requests are used to store data for a future 
| task, the temporary storage program (DFHSG PROGRAM=TSP) must be 
j generated. 


L_ 



PROGRAM=ICP 

[,STAGE2={SELECTIVE|FORCE!] 
[,SUFFIX=xx3 

[,XICEEXP=symbolic-name] 

C,XTYPREQ=symbolie-name3 


PROGRAM=ICP 

indicates that the interval control program is to be generated. 
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STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 


SUFFIX=xx 

is used to provide a one- or two-character alphameric suffix 
for the interval control program being generated. If this 
operand is omitted, a suffix is not provided. 


XICEEXP=symbolic-name 

is used to allow the interval control program to generate 
linkage to a user-written exit routine when an interval control 
element (ICE) has expired. For further information concerning 
user exits, see "User Exits for CICS/VS Management Programs" in 
Chapter 6.2 of this manual. 


XTYPREQ=symbolic-name 

is used to generate linkage to a user-written exit routine at 
the entry point of interval control. For further information 
concerning user exits, see "User Exits for CICS/VS Management 
Programs." 


| ISC — INTERSYSTEM COMMUNICATION GROUP 


The DFHSG PROGRAM—ISC macro instruction must be coded to provide support 
for an intersystem communication session, where one CICS/VS system 
communicates with another. A terminal control table may also be 
generated with a DFHTCT TYPE=ISLINK macro, together with the appropriate 
operands from the DFHTCT TYPE=INITIAL and TYPE=TERMINAL macros. In 
addition, DFHSG PROGRAM=TCP must be generated with ACCMETH=VTAM and 
VTAMDEV=LUTYPE6. 

The DFHSG PROGRAM=ISC macro is also required if DL/I data, base 
sharing is to take place under CICS/OS/VS. A DFHTCT TYPE=IRCBCH macro 
must also be generated, together with the appropriate operands (APPLID 
and IRBUFSZ) from the DFHTCT TYPE=INITIAL macro. In addition, DFHSG 
PR0GRAM=TCP must contain ACCMETH=IRC. 

The following programs are generated by the DFHSG PROGRAM=ISC macro 
instruction: 
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| • DFHISP - intersystem communication program 

| • DFHMIR - intersystem and inter-region communication "mirror" module. 

| For further information on the special 

j considerations associated with generating DFHMIR, refer to the 

| appropriate CICS/VS System Programmer * s Guide 


| (DOS/VS or OS/VS). 

| • DFHELR - EXEC local/remote program 

| • DFHXFP - transformer program, which converts the CICS/VS parameter 
| list into the required architected parameter list. 

| • DFHCRSP - DL/I shared data base start-up program (OS/VS only) 

| • DFHCRNP - DL/I shared data base new connection program (OS/VS only) 

| • DFHIRCP - DL/I shared data base inter-region SVC (OS/VS only) 

| • DFHXFQ - DL/I shared data base batch transformer program (OS/VS only) 

| • DFHDRP - DL/I shared data base "bootstrap" program (OS/VS only) 

| • DFHCRC - DL/I shared data base CICS/VS STAE exit program (OS/VS only) 

| • DFHDRPA through DFHDRPF - batch region controller modules (OS/VS only) 



j DFHSG 

1 

PROGRAM=ISC 



1 

1 

1 

I 

[,SUFFIX=xx] 



1 

1 

f 

1 

1 

f 

For OS/VS only 



I 

1 

I 

1 

[,IRCSVC=number] 



| PR0GRAM=ISC 

j indicates that the intersystem communication group is to be 

j generated. 


| SUFFIX=xx 

j provides a one- or two-character suffix for the group of 

| intersystem communication programs being generated. Only 

j DFHMIR does not receive this suffix. If this operand is 

j omitted, a suffix is not provided. 


| For CICS/OS/VS only 


| IRCSVC=number 

| specifies the type 2 SVC number under which the inter-region 

j communication SVC routine provided by CICS/VS is to be link- 

j edited into the appropriate OS/VS system. The purpose of the 

| SVC routine is to pass data and control between the CICS/VS 

j region and the batch regions during a DL/I shared data base 

| session. The number specified must be in the range 200 through 

| 255. 
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JCP 


JOURNAL CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
journal control program is DFHSG PROGRAM=JCP. The following journal 
control modules are generated in response to this macro instruction: 

• Journal control program (DFHJCP) 

• Journal control close program (DFHJCC) 

• Journal control open program (DFHJCO) 

• Journal control end of volume program (DFHJCEOV) 

• Journal control open/close program (DFHJCOCP) 

• Journal control journal format program (DFHJCJFP) 

• Journal control I/O error program (DFHJCIOE) 

• Journal control boot strap program (DFHJCBSP) 

• Journal control kick-off journaling program (DFHJCKOJ) 

• Journal control shut down journaling program (DFHJCSDJ) 

• Journal control input program (DFHJCI) 

Notes : 

1. For CICS/DOS/VS, if journal control is used, the DOS/VS supervisor 
used must be generated with AP=YES. Refer to the CICS/VS System 
Programmer's Guide (DOS/VS) . 

2. DOS/VS users should ignore any DFHJCOCP assembly errors that occur 
if the tape macros DTFMT and MTMOD have been deleted from the 
source statement library. 


[ 

|DFHSG 

- r- 

1 

PROGRAM=JCP 


-1 


i 

1 

t,AUTOJRN={NO|YES}3 




i 

1 

[,DTB={NO|AUX j MAIN>] 




i 

1 

l , DUMMY=YESl 




i 

1 

[,NOTE={NO|YESJ] 




i 

1 

[,STAGE2={SELECTIVE|FORCE}] 




i 

1 

t,SUFFIX=xx] 



L_ 

i 

_ i___ 

1 

— L- 

[,UPRFX={NO|YES}3 


_J 


PROGRAM=J CP 

indicates that the journal control program is to be generated. 


AUTOJRN=N 01YES 

specifies whether automatic journaling is to be supported. 
AUTOJRN=YES must be specified if: 


• Automatic journaling of file accesses is requested for 
particular files or terminals. 

• The emergency restart function is required. 
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The dynamic transaction backout function is required* 


• DL/I is to be used. 


NO 

indicates that automatic journaling will not be supported. 

YES 

indicates that automatic journaling will be supported. 


DTB=NO|AUX[MAIN 

indicates whether automatic logging will be performed to 
support the dynamic transaction backout function, which keeps 
copies of specific system log information in a dynamic in-core 
buffer. The default is DTB=NO. 

NO 

indicates that the dynamic transaction backout program is 
not required, and that the code to build the dynamic log 
will not be generated. 

AUX 

indicates that log records will spill into CICS/VS 
auxiliary temporary storage on direct access storage 
devices when the dynamic buffer is full. If this option is 
specified, the temporary storage program must be generated 
with AUX—YES or AUX=REC. 


MAIN 

indicates that CICS/VS main temporary storage will be used 
when log records spill from the dynamic buffer. The 
temporary storage program must be generated if this option 
is selected. 


DUMMY=YES 

specifies that a dummy journal control program is to be 
generated. 

This operand may be used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy journal control program. Any 
other operands which may have been included in the DFHSG 
PR0GRAM=JCP macro instruction are ignored. 


N0TE=N0|YES 

specifies whether "Note" requests to obtain positioning 
information for journal data sets are to be supported. 
NOTE=YES is required to use the DFHJC TYPE=NOTE macro 
instruction. The default is NOTE=NO. 

NO 

indicates that "Note" requests will not be supported. 

YES 

indicates that "Note" requests will be supported. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 
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SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library- 


FORCE 

forces generation of all Stage 2 jobs for this program. 
Note : Stage 2 will always be produced for DFHJCP. 


SUFFIX=xx 

provides a one- or two-character suffix (other than NO or DY, 
which are reserved) for the set of journal control program 
being generated. Only DFHJCP receives this suffix. If this 
operand is omitted, a suffix is not provided. 


UPRFX=NO|YES 

specifies whether user prefix creation is to be supported for 
output journal records. UPRFX=YES is required to use the 
PFXADDR and PFXLGTH operands of the DFHJC macro instruction. 
The default is UPRFX=NO. 

NO 

indicates that user prefix creation will not be supported. 

YES 

indicates that user prefix creation will be supported. 


KCP — TASK CONTROL PROGRAM 


The system generation macro instruction necessary to generate the task 
control program is DFHSG PROGRAM=KCP. Unless otherwise indicated, the 
omission of an operand results in the corresponding function not being 
included. 

The following programs are generated in response to this macro 
instruction: 

• Task control program (DFHKCP) 

• Sync point program (DFHSPP) 



|DFHSG 

1 

PROGRAM=KCP 



1 

1 

[,OPSECUR= CNO|YES}] 



1 

1 

(,STAGE2={SELECTIVE|FORCE}J 



1 

1 

t,SUFFIX=xxl 



1 

1 

[,XDSPCHR=symbolic-name] 



1 

1 

[ , XTYPREQ=symbolic-name3 



PROGRAM=KCP 

indicates that the task control program is to be generated. 
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OPSECUR—NO|YES 

indicates whether the optional operator security checking 
feature of task control is to be included in CICS/VS. The 
default is OPSECUR=NO. 

NO 

indicates that operator security checking will not be 
included. 

YES 

indicates that operator security checking will be included. 
If this option is specified, DFHSG PROGRAM=CSS must also be 
generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : In CICS/OS/VS, Stage 2 jobs will always be produced for 

DFHKCP. 


SUFFIX=xx 

is used to provide a one- or two-character alphameric suffix 
for the pair of task control programs being assembled. The 
sync point program is not suffixed. If this operand is 
omitted, a suffix is not provided. 


XDSPCHR=symbolic-name 

is used to generate linkage to a user-written exit routine at a 
point in the task dispatcher subsequent to determining which 
task to dispatch, but prior to passing control to the task. 

For further information concerning user exits, see "User Exits 
for CICS/VS Management Programs" in Chapter 6.2 of this manual. 


XTYPREQ=symbolic-name 

is used to generate linkage to a user-written exit routine at 
the point in task control prior to determining what type of 
request for task services was issued. For further information 
concerning user exits, see "User Exits for CICS/VS Management 
Programs." 
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KPP 


KEYPOINT PROGRAM 


The keypoint program (DFHSG PROGRAM=KPP) is used for collecting and 
recording data from system tables and control blocks, and for writing 
that information to the restart data set and to the system log. This 
data is used by the system intialization program (DFHSIP) in warm starts 
of CICS/VS, and by the recovery utility program (DFHRUP) and transaction 
backout program (DFHTBP) in emergency restarts of CICS/VS. 



PROGRAM=KPP 

[,AKP={N0|YES}3 

(,DUMMY=YES) 

[,RSDBLKS={512|number}3 

[ f STAGE2={SELECTIVE|FORCE}3 

[,SUFFIX=xx3 

For DOS/VS Only 

{.DEVICE^C 2314 133301334013350}3 


PROGRAM=KPP 

indicates that the keypoint program is to be generated. 


AKP=NO|YES 

specifies whether activity keypointing is to be supported. The 
default is AKP=NO. 

NO 

specifies that activity keypointing support will not be 
generated. 


YES 

specifies that this support will be generated. Specifying 
this option causes the following programs to be generated: 


Activity keypoint program (DFHAKP) 

Recovery utility program (DFHRUP) 

Transient data recovery program (DFHTDRP) 
Format log tape program (DFHFTAP) 

Log tape end of file program (DFHTEOF) 
Temporary storage recovery program (DFHTSRP) 


Notes : 

1. AKP=YES must be specified if the emergency restart function 
is required. 

2. DOS/VS users should ignore any assembly errors that may 
occur in the DFHFTAP and DFHTEOF modules if the tape macros 
DTFMT and MTMOD have been deleted from the source statement 
library. DFHFTAP and DFHTEOF are not required on DOS/VS 
disk-only systems. 
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DUMMY=YES 

indicates that a dummy keypoint program is to be generated. 

This operand may be used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy keypoint program. Any other 
operands which may have been included in the DFHSG PROGRAM=KPP 
macro instruction are ignored. 


RSDBLKS =nnn 

specifies the block size of the restart data set. The minimum 
and default is 512, and the maximum is the track capacity of 
the device on which the data set resides. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 
Note : Stage 2 jobs will always be produced for DFHKPP. 


SUFFIX=xx 

indicates a one- or two-character suffix (other than NO or DY 
which are reserved) for the keypoint program being generated. 
Only DFHKPP receives this suffix. If this operand is omitted, 
a suffix is not provided. 


For CICS/DOS/VS only 


DEVICE=device 

specifies the device type on which the restart data set 
resides. The default is provided in the DEVICE operand of 
DFHSG TYPE=INITIAL. DFHKPP will override a default device type 
of TAPE with 2314. 


MTP — MASTER TERMINAL PROGRAM 


The master terminal program (DFHSG PROGRAM=MTP), which is used by the 
master terminal (CSMT), supervisory terminal (CSST), and operator 
terminal (CSOT) transactions, is generated by the following macro 
instruction. 

[ \ DFHSG [ PROGRAM=MTP ] 

I | | C,STAGE2={SELECTIVE|FORCE)] | 

L-L-L-J 
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PROGRAM=MTP 

indicates that the master terminal program is to be generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE^INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : Stage 2 jobs for DFHMTPD are always produced in 

CICS/OS/VS. 


OCP -- DYNAMIC OPEN/CLOSE PROGRA M 


The system generation macro instruction necessary to generate the 
dynamic open/close program is DFHSG PROGRAM=OCP. This macro instruction 
must be issued if the dynamic open/close program is to be used through 
the master terminal facility, or in response to a DFHOC request in an 
application program, or if OPEN=DEFERRED is specified in the DFHFCT 
TYPE=DATASET macro. If this program is to be used, LOCATE must be 
specified in the FILSERV parameter of the DFHSG PROGRAM=FCP macro 
instruction. 

r - r - r - n 

| jDFHSG | PROGRAM=OCP | 

| 1 | (,STAGE2={SELECTIVE|FORCE}] | 

L-L_L_J 


PROGRAM=OCP 

specifies support for the dynamic open/close program. 


STAGE 2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : In CICS/OS/VS, Stage 2 jobs will always be produced for 

DFHOCP. 
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POP 


PROGRAM CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
program control program is DFHSG PROGRAM=PCP. 

I Note : Stage 2 jobs will always be produced for DFHSG PROGRAM=PCP. 



PROGRAM= PC P 

[,COBOL= ( [V23 (,V33 [,V43 [, SUBSET] ) ] 
[,HLLTR=(NO|YES}3 
C , LANG=(COBOL,PLI) |{COBOL|PLI}3 
[, SUFFIX=xx3 
[ ,XFETCH=symbolic-name3 


PROGRAM= PCP 

indicates that the program control program is to be generated. 
| Support for assembler-language and RPG II (DOS/VS only) 

| application programs is automatically provided when this 

j operand is specified. COBOL and PLI support is provided 

j through the LANG operand. 


COBOL=compiler 

is used to indicate which ANS COBOL compilers are to be used to 
compile user-written application programs. 

V2 

indicates that the ANS COBOL Version 2 Compiler (360N-CB- 
482 for DOS/VS, 360S-CB-545 for OS/VS) is to be used. 

V3 

indicates that the ANS COBOL Version 3 Compiler (5736-CB2 
for DOS/VS, 5734-CB1 for OS/VS) or the DOS/VS Compiler 
(5746-CBl) is to be used. 

V4 

indicates that the ANS COBOL Version 4 Compiler (5734-CB2) 
or OS/VS COBOL (5740-CBl) is to be used. 

SUBSET 

indicates that the DOS/VS Subset Compiler (5736-CB1) is to 
be used. 

If this operand is used, LANG=COBOL must also be specified. 


HLLTR=NO|YES 

| specifies whether support for trace requests is to be generated 

for high-level language application programs. If this operand 
is used, the LANG operand must also be used. The default is 
HLLTR=NO. 

NO 

indicates that high-level language trace is not required. 

YES 

indicates that high-level language trace is required. 
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LANG=language 

specifies that the optional language support is to be 
generated. 

COBOL 

indicates ANS COBOL support. 

PLI 

indicates PLI support. Note that this option can also be 
written as PL/I, PLI, or PL/1. 


SUFFIX=xx 

provides a one- or two-character alphameric suffix for the 
program control program being assembled. If this operand is 
omitted, a suffix is not provided. 


XFETCH=symbolic-name 

is used to generate linkage to a user-written exit routine at 
the point in program control following the loading of the 
requested program. This exit is taken during every LINK and 
XCTL, regardless of whether the program was already in main 
storage. The exit is not taken on a LOAD request. For further 
information concerning user exits, see "User Exits for CICS/VS 
Management Programs" in Chapter 6.2 of this manual. 


RSP — RESEND PROGRAM 


The DFHSG PROGRAM=RSP macro instruction generates the following CICS/VS 
programs, which handle abnormal conditions and error situations in a 
CICS/VS system that is communicating with logical units: 

• DFHZRSP - Resend program 

• DFHZRLG - Response logging program 

• DFHZNAC - Node abnormal condition program 

• DFHZNEP - Node error program 


r - r - r - 

| jDFHSG j PROGRAM=RSP 

| | | ,RESEND={NO|YES> 

j j | t,STAGE2={SELECTIVE1 FORCE}] 



PROGRAM=RSP 

specifies that CICS/VS abnormal condition and error-handling 
functions for logical units are to be generated. 


RESEND=YESI NO 

specifies whether the CICS/VS function for resending messages 
following emergency restart or a VTAM session failure is to be 
included in the CICS/VS system. The default is NO. 

YES 

specifies that the resend support is to be included. 
RESEND=YES must be specified for the 3614. 
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NO 

specifies that resend support is not generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program, 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : Stage 2 jobs will always be produced for DFHZRSP in 

CICS/DOS/VS , and for DFHZRSP and DFHZRLG in CICS/OS/VS. 


SCP — STORAGE CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
storage control program is DFHSG PR0GRAM=SCP. The programs that are 
generated by this macro are as follows: 

• Storage control program (DFHSCP) 

• Storage control recovery program (DFHSCR) 


r - r - r - * 



|DFHSG 

i 

PROGRAM= SCP 



i 

i 

i 

i 

i 

i 

[,RECOVER 3 {NO|YES}] 

C,STAGE2={SELECTIVE|FORCE}] 

C,SUFFIX=xx3 


[ _ 

i 

_ i— _ 

i 

_L. 

[,XTYPREQ=symbolic-name] 

- - _ J 


PROGRAM=SCP 

indicates that the storage control program is to be generated. 


RECOVER=NO|YES 

specifies whether storage recovery (rebuilding chains) is to be 
attempted. The default is RECOVER=NO. 

NO 

indicates that storage recovery will not be attempted, and 
will result in the termination of CICS/VS if a storage 
violation is detected by the CICS/VS storage control 
program. 

YES 

indicates that storage recovery will be attempted. A 
storage violation will result in control being passed to 
either the CICS/VS storage control recovery (SCR) routine 
or to a user-written recovery program. (See "User Exits for 
CICS/VS Management Programs" in Chapter 6.2 of this 
manual.) 
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STAGE2=SELECTIVEI FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 


SUFFIX=xx 

is used to provide a one- or two-character alphameric suffix 
for the storage control program and storage control recovery 
program being assembled. If this operand is omitted, a suffix 
is not provided. 


XTYPREQ=symbolic-name 

is used to generate linkage to a user-written exit routine at 
the entry point of storage control. For further information 
concerning user exits, see "User Exits for CICS/VS Management 
Programs" in Chapter 6.2. 


SRP — SYSTEM RECOVERY PROGRAM 


The system recovery program (DFHSG PROGRAM=SRP) is a generalized 
abnormal termination handler which is given control by the operating 
system via the STXIT PC or STXIT AB (DOS/VS) macros, and the SPIE, STAE 
or ESTAE (OS/VS) macro instructions. 

The system generation macro instruction necessary to generate the 
system recovery program is: 


r - r - r - 

j (DFHSG I PROGRAM= S RP 

| II [,DUMMY=YESl 

| j | [,STAGE2={SELECTIVE|FORCE}] 

| | | E, SUFFIX=xxl 

t-L-L- 


I 

I 

I 

I 


PROGRAM=SRP 

indicates that the system recovery program is to be generated. 
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DUMMY=YES 


specifies that a dummy system recovery program is to be 
generated. 

This operand is used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy system recovery program. 

Note ; The dummy SRP module intercepts program checks, allowing 
CICS/VS to perform certain clean-up operations. It will issue 
SPIE (OS/VS) or STXIT PC (DOS/VS) macros, but will not handle 
abnormal terminations. However, unlike the full version of the 
SRP, the dummy SRP does not provide recovery action for program 
checks. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : Stage 2 jobs will always be produced for this program in 

CICS/OS/VS. 


SUFFIX=xx 

is used to provide a one- or two-character alphameric suffix 
(other than NO or DY, which are reserved) for the system 
recovery program being assembled. If this operand is omitted, 
a suffix is not provided. 


TBP -- TRANSACTION BACKOUT PROGRAM 


The transaction backout program (DFHTBP) is responsible for backing out 
changes made to CICS/VS protected resources by transactions which were 
in-flight at the time that the system was interrupted. This program 
must be generated if the keypoint program is generated with AKP=YES. 

DFHTBP is a required component of emergency restart and is also 
responsible for collecting messages to permit message recovery. 

The system generation macro instruction necessary to generate the 
transaction backout program is DFHSG PROGRAM^TBP. 


r- 1 

| |DFHSG | PROGRAM= TBP | 

| | I C,STAGE2={SELECTIVE|FORCE}] | 


j j j [,XDERROR=symbolic-name] | 
| | | [,XFERR0R=symbolic-name3 j 
j | | C,XINIT=symbolic-name] j 
| | j [,XINPUT=symbolic-name3 j 
L_J 
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PROGRAM=TBP 

indicates that the transaction backout program is to be 
generated. 


STAGE 2—SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : Stage 2 jobs will always be produced for this program in 

CICS/OS/VS. 


XDERROR= symbolic-name 

is used to generate linkage to a user-written exit routine when 
an error condition is encountered while attempting DL/I data 
base backout. 


XFERROR= s ymbolic-name 

is used to generate linkage to a user-written exit routine when 
an error is detected while attempting file backout. 


XINIT=symbolic-name 

is used to generate linkage to a user-written exit routine in 
the initialization and termination phases of DFHTBP. 


XINPUT=symbolic-name 

is used to generate linkage to a user-written exit routine 
after a record has been read from the restart data set. 


TCP — TERMINAL CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
terminal control program is DFHSG PROGRAM=TCP. 

The programs generated are: 

• Terminal control programs (DFHTCP, DFHZCP, DFHZCA, DFHZCB, DFHZCY, 
DFHZCX, and DFHZCZ). DFHTCP, DFHZCP, and DFHZCX are for VTAM and 
non-VTAM systems? in a VTAM system, all the modules are needed. 

• Terminal control program print application program (DFHP3270) 

• Terminal control program print application programs for 3270 and 
3790 3270-compatible logical units - (DFHPRK, DFHCPY, DFHRKB, and 
DFHEXI)• 

• CICS/VS VTAM good morning message program (DFHGMM) if ACCMETH=VTAM 
is specified. 
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Note: If SRBSVC=number is specified in DFHSG TYPE=INITIAL, VTAM 

authorized path is used in DFHZCP to give improved performance 
| characteristics. This applies only to 0S/VS2 Release 3.7 (MVS) with 
| shippable units 5 and 7. 


L. 


r- 

I DFHSG 


| PROGRAM=TCP | 

| ,ACCMETH= (methodl,method] ,...) 

I (,ANSWRBK=(identification[,identification!,...)] 
j C ,AUTOTRN=(NO | YES >] 

j [.BSCODE=( EBCDIC.ASCII ) I{EBCDIC IASCII}] 
j [,BTAMDEV=(device[,device],...)] 
j [,CHNASSY={NO|YES}] 
j t.CMPT60L={240.»80.960|nl.n2.n3>] 

| [,COMPAT={NO|((FORMAT](,FULLBUFF](,F2 260])}] 
j [,CONVTAB=([ABB]t,ABC][.2741EU][.2741EM] 

| [.2741CU][.2741CM])] 

j [,DEVICE=(device(,device].... )] 
j [,EODI=[EO|xx>] 

j [,FEATURE=(feature[.feature] ,...)] 

| [.FMT2260=([ 6X40 ][,12X40](,12X80](.15X64])] 

| [,FMT3270=([12X40][,24X80])] 

| [,LOCKF=YESJ 
| (.LOGREC={NO I YES]] 

| [,PIPELN={NO|YES]] 
j [.PUNSOL={ YES I NO] ] 
j (,RAQ=YES] 
j (, SMI= {£ | character}] 
j (,STAGE2={SELECTIVE|FORCE}] 
j [,SUFFIX=xxl 
j (,TAB={NO|YES}] 
j [,TBLFIX={NO|YES}] 
j [,DCTRAN={NOj((EBCDIC][.ASCII])}] 
j [,VTAMDEV=(device,...) 1 
j (,WRAPLST=(NO|YES}] 
j [,XATTACH=symbolic-name] 
j [,XINPUT=symbolic-name] 
j ( ,XOOTPOT=symbolic-name] 
j (,XRDATT=symbolic-name] 
j (,ZATTACH=symbolic-name] 
j ( ,ZINPUT=symbolic-name] 
j [ ,ZOUTPUT=symbolic-name] 

I For/OS/VS only 

| (,INITRL=YES] 

| [,TCM3270=YES] 
j [,XTCMIN=symbolic-name] 
j [,XTCMOUT=symbolic-name] 


PROGRAM=TCP 

indicates that the terminal control program is to be generated. 


ACCMETH=method 

identifies the access method(s) to be used in the terminal 
environment. One or more of the following keyword parameters 
must be specified: 
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Method 


Required 


TCAM - Telecommunications Access Method (OS/VS only) 

BTAM - Basic Telecommunication Access Method 
BSAM - Basic Sequential Access Method 
SAM - Sequential Access Method 
BGAM - Graphics Access Method (0S/VS only) 

VTAM - Virtual Telecommunications Access Method 
EXTM - Extended Telecommunications Modules 
(DOS/VS only - see Note 2 below.) 

IRC - Inter-region communication access method for 
DL/I shared data base support in CICS/OS/VS. 

See note 4. 

SAM and BSAM are functionally synonymous in CICS/VS and can be 
used interchangeably. Only unblocked data sets can be used 
with SAM or BSAM. SAM is required to support the processor 
console as a terminal (CICS/DOS/VS only). BGAM provides the 
2260 support for CICS/OS/VS, while BTAM provides the 2260 
support for CICS/DOS/VS. 

Notes : 

1. If ACCMETH=VTAM is specified, DFHSG PROGRAM=RSP must also 
be generated. 

2. BTAMDEV= must be specified with ACCMETH=EXTM for EXTM- 
supported non-SDLC devices; VTAMDEV= must be specified with 
ACCMETH=EXTM for EXTM-supported SDLC devices. ACCMETH=EXTM 
is only valid when Program Product 5476-XXB is installed 
with CICS/DOS/VS. 

3. ACCMETH=VTAM may not be specified if VTAM=NO was specified 
in DFHSG TYPE=INITIAL. 

4. ACCMETH=IRC generates control code in the group of DFHZCP 
modules for the DL/I shared data base inter-region control 
module. 


BTAMDEV 

DEVICE 

DEVICE 

VTAMDEV 


ANSWRBK=identification 

specifies the type of terminal identification and must be used 
if FEATURE= AUTOANSW is specified. The parameters of this 
operand are not mutually exclusive. This operand is applicable 
only when ACCMETH= BTAM is specified. 

EXIDVER 

specifies that BTAM expanded identification verification is 
to be used to identify those terminals which transmit 
unique identification sequences. ANSWRBK=EXIDVER may be 
specified for all BTAM BSC dial devices (except for the 
2780) which require the expanded ID verification feature. 

TERMINAL 

specifies that the operator will supply the identification 
for switched lines. 

AUTOMATIC 

specifies that automatic terminal identification is to be 
sent by the terminal. This option is only valid for 
BTAMDEV=TWX. 

7770TERM 

specifies that the operator will supply the terminal 
identification. 
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7770NULL 

specifies that no terminal identification is to be sent by 
either the terminal or by the operator; instead, the 
terminal control program will connect the line to the next 
available terminal in the terminal pool. The default is 
ANSWRBK=7 7 7 OTERM, providing BTAMDEV=7770 has also been 
specified. 

Note : The ANSWRBK operand must include all keyword parameters 

for which the corresponding parameter is to be included in the 
DFHTCT TYPE=LINE specification during terminal control table 
preparation. 


AUTOTRN=NOI YES 

specifies whether the optional automatic transaction initiation 
feature is to be included in CICS/VS. The default is 
AUTOTRN=NO. AUTOTRN= YES must be specified if any of the 
following apply: 


I 


• If INTRA=TRANSINIT for DFHSG PROGRAM=TDP and the TRANSID 
operand of the DFHDCT macro instruction are both specified 

• If tasks are to be started by interval control 

• If ROUTING=YES or PAGING=YES are specified for DFHSG 
PRO GRAM= BM S 

• If the Message Switching facility is used 

• If DFHSG PROGRAM=ATP is specified 

• If PRINT=YES f PAl, PA2, or PA3 is specified in DFHSIT, and 
if DFHTACP performs an interval control PUT operation. 
Further details can be found under "3270 Unavailable 
Printer" in Chapter 4.2. 

• If the 3270 print program is to be used for BTAM devices 
(this implies a task that is initiated by interval 
control). 

• If the execution (command level) diagnostic facility (EDF) 
is used in two-terminal mode (that is, if the direct 
terminal for the transaction being tested is a different 
terminal to that on which the facility is displayed). 


NO 

indicates that automatic transaction initiation will not be 
supported. 

YES 

indicates that automatic transaction initiation will be 
supported. 


BSCODE—EBCDIC|ASCII 

specifies which types of binary synchronous communication code 
are to be supported when ACCMETH= BTAM is specified. The 
default is BSCODE=(EBCDIC,ASCII). 

EBCDIC 

indicates Extended Binary Coded Decimal Interchange Code. 
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ASCII 

indicates American Standard Code for Information 
Interchange. 


BTAMDEV=device 

identifies the BTAM device types and must be present if 
ACCMETH=BTAM is specified. The applicable keyword parameters 


• 1050 1050 Data Communication System 

• 1050D 1050 Data Communication System (dial-up) 

• 1053 1053 on a Local/Remote 2848 Control Unit 

• 2260 2260 Display Station (Remote) 

• L2260 2260 Display Station - Local (CICS/DOS/VS only) 

• 2265 2265 Display Station 

• 2740 2740 Communication Terminal Model 1 

• 2740D 2740 Communication Terminal Model 1 (dial-up) 

• 2740-2 2740 Communication Terminal Model 2 (2740 must 

also be specified) 

• 2741C 2741 Communication Terminal with correspondence code 

• 2741E 2741 Communication Terminal with PTTC/EBCD code 

• 2741DC 2741 Communication Terminal with correspondence 

code (dial-up) 

• 2741DE 2741 Communication Terminal with PTTC/EBCD 

code (dial-up) 

• 2770 2770 Data Communication System 

• 2770D 2770 Data Communication System (dial-up) 

• 2780 2780 Data Transmission Terminal 

• 2780D 2780 Data Transmission Terminal (dial-up) 

• 2980/1 2980 General Banking Terminal System Model 1 

• 2980/2 2980 General Banking Terminal System Model 2 

• 2980/4 2980 General Banking Terminal System Model 4 

• 3275 3275 Display Station (remote) 

• 3275D 3275 Display Station (dial-up) 

• 3277 3277, 3276, and 3278 Display Station (remote) 

• L3277 3277 and 3278 Display Station (local) 

• 3284 3284, 3287, and 3289 Printer (remote) 

• L3284 3284, 3287, and 3289 Printer (local) 

• 3286 3286, 3287, and 3289 Printer (remote) 

• L3286 3286, 3287, and 3289 Printer (local) 

• 3600 3600 Finance Communication System 

• 3660 3660 Supermarket System 

• 3735D 3735 Programmable Buffered Terminal (dial-up) 

• 3740 3740 Data Entry System 

• 3740D 3740 Data Entry System (dial-up) 

• 3780 3780 Data Communication Terminal 

• 3780D 3780 Data Communication Terminal (dial-up) 

• 7770 7770 Audio Response Unit Model 3 

• SYS/3 System/3 Models 6 and 10 

• SYS/3D System/3 Models 6 and 10 (dial-up) 

• SYS/7 System/7 

• SYS/7D System/7 (dial-up) 

• S/370 System/370 

• S/370D System/370 (dial-up) 

• S/7BSCA System/7 with Binary Synchronous Communications 

Adapter 

• S/7BSCAD System/7 with Binary Synchronous Communications 

Adapter (dial-up) 

• TLX Teletypewriter (WTC only) 

The Autocall feature is not supported by CICS/VS. 
(This feature is for World Trade users only.) 

• TWX CPT-TWX (Model 33/35) 

• BISYNC Binary synchronous device (for ClCS/OS-STANDARD 

VI compatibility) 
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Note: BTAMDEV=3286 or L3286 also generates support for the 

3288 printer. 

Individual device type parameters are provided for the BTAMDEV 
operand so that system generation input is self-documenting. 

If the parameter length for this operand exceeds the assembler 
limit of 255 characters for the particular system being 
generated, synonymous parameters can be omitted. Specifying 
any one of the parameters from a group produces supportive code 
for all devices in the group. These groups are: 


• SYS/3,S/370,BISYNC,S/7BSCA 

• SYS/3D,S/370D,S/7BSCAD,3660 

• 3275,3277,3276,3278 

• 3284,3286,3287,3289 

• L3284,L3286 

• 2260,2265 

Note : When binary synchronous communication lines are part of 

the user's configuration, it is possible for these 
communication lines to time out if control is not returned to 
the terminal before a timeout can occur. The user can 
alleviate this condition by having the application program 
issue a CICS/VS task control WAIT macro instruction to 
relinquish control voluntarily. 


CHNASSY=YES|NO 

indicates whether the facility is required for reading a 
complete SNA chain of logically grouped records before 
presenting any of the input data to the application program. 
This operand is only to be used when ACCMETH=VTAM is specified. 
The default is CHNASSY=NO. 


YES 

specifies that chain assembly support is to be generated in 
the ZCP group of modules. CHNASSY=YES must be specified 
for 3270 compatibility mode support and will be forced if 
this support is generated. Note that 3270 compatibility 
mode support is automatically generated when VTAMDEV=3790 
or LUTYPE2 is specified in this macro. 

NO 

specifies that chain assembly support is not to be 
generated in the ZCP group of modules. 


CMPT60L=number 

specifies the minimum size of the terminal input output area 
(TIOA) that will be passed when an input operation completes 
for any transaction running under 2260 compatibility. This 
operand must be specified if any of the transactions that are 
to be run under 2260 compatibility requires an input TIOA 
larger than the standard compatibility default. The default 
values are CMPT60L=(240,480,960). If a value is supplied for 
any of the parameters which is smaller than the corresponding 
default, the default value will be used. This operand 
corresponds in function to the INAREAL specification formerly 
made in the DFHTCT TYPE=LINE macro instruction for the 
2260/2265 configuration. 


Chapter 2.2. DFHSG PROGRAM=TCP 


73 




nl 

indicates the minimum size TIOA for a 3270 simulating a 240 
character screen size 2260/2265* 

n2 

specifies the minimum size TIOA for a 480 character screen 
size simulation* 

n3 

specifies the minimum size TIOA for a 960 character screen 
size simulation. 


COMPAT=NO1FORMAT|FULLBUF|F2 2 6 0 

generates 2260-compatibility support for the 3270 Information 
Display System. Such support allows the user to run his 
currently operational 2260-based transactions from a 3270. 

This support is not available for 3270 or 3790 3270-compatible 
logical units. The default is COMPAT=NO. 

NO 

indicates that 2260-compatibility support for the 3270 is 
not to be generated. 

FORMAT 

indicates that FORMAT compatibility mode is to be 
generated. FORMAT mode takes full advantage of the 3270 
formatting and data compression facilities, and is the 
preferred method of 2260-compatibility operation, 
particularly for the operation of remote 3270s. 

FULLBUF 

indicates that FULLBUF compatibility mode is to be 
generated. FULLBUF mode does not use the 3270 data 
compression facilities and must therefore be used when all 
lines of input data are required. 

F2260 

indicates that FASTER 2260 compatibility support for the 
3270 Information Display System is to be generated. This 
support allows the user to execute a currently operational 
FASTER 2260-based transaction using a 3270 terminal. 

Notes : 

1. If COMPAT=FORMAT and/or FULLBUFF is specified, FMT2260 and 
FMT3270 must be used to specify the screen formats. 

2. If a 480-character 2260 is mapped onto a 480-character 
3270, use of FORMAT mode causes the loss of the last 
character of each 2260 output line. Use of FULLBUF mode 
limits the data loss to the last character position of the 
last line but at the expense of transferring a full 480 
characters for each interaction involving a data entry key. 


CONVTAB=conversion-type 

specifies the type of conversion to be performed on the data 
received from the 7770 Audio Response Unit or the 2741 
terminal. If BTAMDEV=7770, CONVTAB=ABB and/or ABC applies. 

The default is CONVTAB=(ABB,ABC). If BTAMDEV=2741E and/or 
2741DE, CONVTAB=2741EU and/or 2741EM applies. The default is 
C0NVTAB=2741EU. If BTAMDEV=274lC and/or 2741DC, CONVTAB=2741CU 
and/or 2741CM applies. The default is C0NVTAB=2741CU. 
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ABB 


indicates conversion from ABB transmission code. 


ABC 

indicates conversion from ABC transmission code. 

2741EU 

indicates that data received from a 2741 EBCDIC terminal 
will be translated to uppercase. 

2741EM 

indicates that data received from a 2741 EBCDIC terminal 
will be translated to text mode. 

2741CU 

indicates that data received from a 2741 correspondence 
terminal will be translated to uppercase. 

2741CM 

indicates that data received from a 2741 correspondence 
terminal will be translated to text mode. 

Note : The 2741 Autocall feature is not supported by CICS/VS. 


DEVICE=device 

identifies the direct access or sequential devices that are to 
be used in the terminal environment. This operand must be used 
if ACCMETH=SAM or ACCMETH=BSAM is specified. The applicable 
parameters are: CRLP (card reader, line printer), DASD, TAPE, 
and CONSOLE (CICS/DOS/VS only). 


EODI=xx 

specifies the end-of-data indicator for sequential input. The 
characters xx represent two hexadecimal characters in the range 
01 to FF. The default is EODI=EO which is equivalent to the 0- 
2-8 punch formerly used as an end-of-data indicator. 


FEATURE= f eature 

specifies the special features present in the terminal 
environment. The applicable keyword parameters are: 


• AUTOANSW 


• AUTOPOLL 


• BUFFRECV 

• PSEUDOBIN 

• TRANSPARENCY 

• RDATT 

• WRBRK 


Automatic answer. This enables a control 
unit to respond automatically to a call 
received over a switched line. When BTAM is 
used, this feature is required for the 
3275 and for all dialed devices. 

Automatic polling feature. When BTAM is 
used, this feature is required for multipoint 
BSC terminals. 

Buffered receive feature for 2740 Model 2. 
Pseudo-binary transmission code for System/7 
Character transparency for the 2770,2780, 

3600 BSC, S/3, S/370, and S/7BSCA. 

2741 Read Attention feature 

2741 Write Break feature (OS/VS only) 


FMT2260=2260-screen-format 

specifies the various 2260 screen formats to be simulated for 
2260-based transactions on the 3270 Information Display System. 
The default is FMT2260=6X40. The applicable keyword parameters 
are: 
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6X40 


240-character 2260 Display Station 
12X40 

480-character 2260 Display Station 
12X80 

960-character 2260 Display Station 
80-column format for the 2265 Display Station 
15X64 

15-row f 64-column format for the 2265 Display Station 


FMT3270=3270-screen-format 

specifies the 3270 screen formats on which 2260 screen formats 
are to be simulated for 2260-based transactions. The default 
is FMT3270=12X40. The applicable keyword parameters are: 

12X40 

480-character 3275/3277 Display Station 
24X80 

1920-character 3275/3277 Display Station 


LOCKF=YES 

specifies that the optional keyboard lock feature, supporting 
the 2848 models 21 and 22, is to be included in CICS/VS. The 
FEATURE=KBRDLOCK operand must be included in the DFHTCT 
TYPE=LINE macro instruction to have the keyboard lock feature 
operative for that line. This operand applies only to 2260 
devices. For CICS/DOS/VS, if LOCKF=YES is specified and if 
FEATURE=KBRDLOCK is included in the DFHTCT TYPE=LINE macro 
instruction, the keyboard is locked on all reads including the 
initial read. 


LOGREC=YES|NO 

indicates whether the facility is required for deblocking input 
records so that the application program can read each logical 
record. The default is LOGREC=NO. This operand only applies 
when ACCMETH= VTAM is specified. 

YES 

specifies that logical record presentation support is to be 
generated in the ZCP group of modules. 


specifes that logical record presentation support is not to 
be generated in the ZCP group of modules. 


PIPELN=YES|NO 

indicates whether 3600 or 3650 pipeline session support is 
required. The default is NO. 

YES 

specifies that 3600 or 3650 pipeline session support is 
required. PIPELN=YES is required for 3606/3608 and 3653 
pipeline sessions. SESTYPE=PIPELINE must also be indicated 
in DFHTCT TYPE=TERMINAL. 
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NO 


specifies that 3600 or 3650 pipeline session support is not 
required. 


PUNSOL=YESf NO 

may be used to generate support for protecting the 3270 logical 
unit from receiving unsolicited input. The default is 
PUNSOL=YES. 

In normal operation, the 3270 terminal operator is expected to 
wait until the keyboard is unlocked by a reply from the 
application program before attempting to enter further input. 
Use of the reset key to allow further input before the 
application program replies is not regarded as normal use of 
the terminal. The specification of PUNSOL=YES will protect 
application programs from receiving such unsolicited input 
(which may cause a synchronization problem between the operator 
and the application program). CICS/VS can check for receipt of 
such unsolicited data and discard it, without giving any 
indication that it was received. The default is YES. PUNSOL 
need not be specified for a 3270 compatibility mode logical 
unit because the compatibility mode controller function 
protects CICS/VS from unsolicited input. 

YES 

indicates that protection is required. 

NO 

indicates that protection will not be provided. 


RAQ=YES 

indicates that the read-ahead-queuing feature of CICS/VS is 
required to initiate input before application program requests 
are made. This feature applies only to logical units, and 
temporary storage must also be generated for queueing and 
dequeueing this data. 


SMI=character 

specifies the character that is to represent the start of 
message indicator (SMI) in all messages to and from the 3270 
operating in 2260 compatibility mode. This character is 
generated as a X* 4A' and must be a valid alphameric displayable 
character. If the SMI character is contained in an output data 
stream, its display is dependent upon the language feature 
specified for the 3270. The character chosen remains the same 
for all transactions. The default is SMI=£. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 
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FORCE 

forces generation of all Stage 2 jobs for this program. 

Note ; Stage 2 jobs will always be produced for DFHTCP, DFHZCP, 
DFHZCB, DFHZCX, and DFHZCZ. 


SUFFIX=xx 

provides a one- or two-character alphameric suffix for the 
terminal control programs (DFHTCP, DFHZCP, DFHZCB, DFHZCX, and 
DFHZCZ) being assembled. If this operand is omitted, a suffix 
is not provided. 


TAB=NO|YES 

specifies whether any of the 2260-compatible 3270 transactions 
make use of the 2260 tab feature. The default is TAB=NO. 

NO 

indicates that the 2260 tab feature is not used. 

YES 

indicates that all colon (:) characters are honored as 2260 
tab characters when included in the 3270 output data 
stream. 


TBLFIX=NO1 YES 

specifies the generation of the 2980 translate tables. The 
default is TBLFIX=NO. 

NO 

causes the generation of skeleton translate tables which 
are used to build the translate tables dynamically each 
time input or output is converted. This is used to 
conserve storage. 

YES 

uses a set of preassembled tables for better performance. 


UCTRAN=N0|EBCDIC|ASCII 

generates instructions for the translation of lowercase data to 
uppercase in 3270, 3767, and 3770 SDLC input data streams. The 
default is UCTRAN=NO. 

NO 

indicates that uppercase translation is not required. 

EBCDIC 

indicates that EBCDIC support is to be generated, when 
FEATURE=UCTRAN is specified in DFHTCT TYPE=TERMINAL for; 

- VTAM 3270s 

- SDLC 3767s and 3770s 

- Non-VTAM 3270s when BSCODE=EBCDIC and/or CONVTAB=EBCDIC 
is specified in DFHTCT TYPE=LINE 

BSCODE and CONVTAB do not apply for 3270 or LUTYPE2 logical 
units, so UCTRAN=EBCDIC will generate translation support 
for all 3270s. 
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| ASCII 

I indicates that support is to be generated for BTAM 3270s. 

For BSC 3270s, translation is available by means of NCP 
translation tables in the 3704/3705. There is no support 
for ASCII encoded data received from 3270 compatibility 
mode logical units. 

| Uppercase translation for the 3270, 3767, or 3770 SDLC devices 

is only performed on input data streams received from those 
devices for which FEATURE=UCTRAN was specified in the DFHTCT 
TYPE=TERMINAL macro instruction, except to satisfy DFHTC 

| TYPE=TEXT or terminal control ASIS requests. Translation is 

not performed on data copied from a display to a printer. 


VTAMDEV=device 

identifies the logical units and must be present if 
ACCMETH=VTAM is specified. The applicable keyword parameters 
are: 


3600 3600 Finance Communication System 

3614 3614 Consumer Transaction Facility 

3650 3650 Retail Store System 

3790 3790 Communication System 

| 3270 3270 Information Display System. (Does not include 

| support for 3270s running as an LUTYPE2, LUTYPE3 

| or SCSPRT logical unit) 

BCHLU Batch Logical Unit support 

| 3770 3770 Data Communication System (Batch Logical Unit) 

3770B 3770 Data Communication System (Batch Logical Unit) 

INTLU Interactive Logical Unit (flip-flop mode) 

3767 3767 Communication Terminal operating as INTLU 

3767C 3767 Communication Terminal operating as an interactive 

logical unit in contention mode 

| 37671 3767 Communication Terminal operating as INTLU 

3770C 3770 Data Communication System (models 3771, 3773, 3774, 

3775 only) operating as an interactive logical unit 
in contention mode 

37701 3770 Data Communication System operating as INTLU 

| LUTYPE6 Session Type 6 Logical Unit for intersystem communication 

| support 

LUTYPE2 SNA type 2 logical unit (3270-compatibile 
logical unit) 

LUTYPE3 SNA type 3 logical unit (3270 printer logical 
unit) 

SCSPRT SCS printer logical unit (for example, 3287, 3289) 
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• INTLU generates support for 3767 and 3770 (models 3771, 

3773, 3774, and 3775 only) interactive logical units in 
flip-flop mode, and for VTAMDEV=SCSPRT. 3767, 37671, and 
37701 may also be specified. 

• BCHLU (or 3770 or 3770B) also generates support for the 
3770 batch data interchange and 3770 full function logical 
units. 

• VTAMDEV=3790 generates support for LUTYPE2, LUTYPE3, and 
SCSPRT logical units. 


WRAPLST=NO|YES 

specifies whether the optional wrap list feature is to be 
included in CICS/VS. The list to be constructed is a wrap¬ 
around polling list for a nonswitched line. The polling list 
is to be constructed in the terminal control table. This 
operand is for BTAM only. The default is WRAPLST=NO. 

NO 

indicates that a wrap list will not be used for polling. 


YES 

indicates that a wrap list will be used for polling. 


XATTACH=symbolic-name 

generates linkage in the terminal control program to a user- 
written exit routine. The linkage is generated at the point 
prior to issuing a task control ATTACH for a transaction 
identification which is received in response to polling. For 
further information concerning user exits, see "User Exits for 
CICS/VS Management Programs" in Chapter 6.2 of this manual. 


XINPUT=symbolic-name 

generates linkage in the terminal control program to a user- 
written exit routine. The linkage is generated at the point 
following completion of any input event. For further 
information concerning user exits, see "User Exits for CICS/VS 
Management Programs." 


XOUTPUT= s ymbolic-name 

generates linkage in the terminal control program to a user- 
written exit routine. The linkage is generated for output 
events at the point prior to translating or framing output 
data. For further information concerning user exits, see "User 
Exits for CICS/VS Management Programs." 


XRDATT=symbolic-name 

generates linkage in the terminal control program to a user- 
written read attention exit. The linkage is generated at the 
point following completion of a read attention for which a 
| terminal input request with the RDATT=address parameter was 

issued. For further information, see "User Exits for CICS/VS 
Management Programs." 
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ZATTACH==symbolic-name 

generates linkage in the terminal control program to a user- 
written exit routine (VTAM only). The linkage is generated at 
the point prior to issuing a task control ATTACH for a 
transaction identification which is received in response to 
polling. For further information concerning user exits, see 
"User Exits for CICS/VS Management Programs." 


Z INPUT=symbolic-name 

generates linkage in the terminal control program to a user- 
written exit routine (VTAM only). The linkage is generated at 
the point following completion of any input event. For further 
information concerning user exits, see "User Exits for CICS/VS 
Management Programs." 


ZOUTPUT=symbolic-name 

generates linkage in the terminal control program to a user- 
written exit routine (VTAM only). The linkage is generated for 
output events at the point prior to translating or framing 
output data. For further information concerning user exits, 
see "User Exits for CICS/VS Management Programs." 


For CICS/OS/VS only 


INITRL=YES 

specifies that all reads from other than an application program 
are with the keyboard lock option. The FEATURE=KBRDLOCK 
operand must be included in the DFHTCT TYPE=LINE macro 
instruction to have the keyboard lock feature operative for 
that line. This operand applies only to 2260 devices. 


TCM3270=YES 

is required if TCAM support includes the 3270 Information 
Display System. 


XTCMIN=symbolie-name 

is used (for TCAM only) to generate linkage to a user-written 
exit routine. The linkage is generated following completion of 
any input event. 


XTCMOUT=symbolic-name 

is used to generate linkage in the terminal control program 
TCAM module to a user-written exit routine. 

The linkage is generated for output events prior to placing 
data on the output queue. 


TDP — TRANSIENT DATA CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
transient data control program is DFHSG PROGRAM=TDP. Unless otherwise 
indicated, the omission of an operand results in the corresponding 
function not being included. If neither INTRA or EXTRA is specified, a 
dummy transient data program will be generated. 
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| The device type for use with intrapartition transient data via DAM 
| (for DOS/VS only) is specified in the DFHDCT TYPE=INITIAL macro* 



j DFHSG 

j PROGRAM=TD P 



1 

| t,DESTRCV={NO|YES}] 



1 

j [,DUMMY=YES] 



1 

j ( , EXTRA=({ACQUISITION!,DISPOSITION))1 



1 

j [,INTRA={YES|TRANSINIT}] 



1 

| [,STAGE2={SELECTIVE!FORCE}] 




| t,SUFFIX=xx] 



1 

j C,XINPUT=symbolic-name] 



1 

j [,XOUTPUT=symbolic-name] 



1 

j [ , XTYPREQ=symbolic-name] 



_t- 


PROGRAM=TDP 

indicates that the transient data control program is to be 
generated. 


DESTRCV=NOI YES 

indicates whether support is to be included to enable emergency 
restart or dynamic transaction backout of intrapartition 
transient data destinations specified as recoverable in the 
destination control table. The default is DESTRCV=NO. 

NO 

indicates that this support will not be generated. 

YES 

indicates that the support will be included for transient 
data recovery. See the description of "Generating 
Recovery/Restart Support" later in this chapter, and in 
| Chapter 4.8. 


DUMMY=YES 

specifies that a dummy transient data control program is to be 
generated. 

This operand is used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy transient data control program. 
Any other operands which may have been included in the DFHSG 
PROGRAM=TDP macro instruction are ignored. 


EXTRA=ACQUISITION|DISPOSITION 

specifies that extrapartition data sets are to be used. 

ACQUISITION 

indicates input from an extrapartition data set. 
DISPOSITION 

indicates output to an extrapartition data set. 

Note : For further information concerning extrapartition data 

sets, see the section on transient data in the appropriate 
CICS/VS Application Programmers Reference Manual . 


INTRA=YES|TRANSINIT 

specifies that intrapartition queues are to be used. 
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YES 


indicates that intrapartition queues (without automatic 
task initiation) are to be used. 

TRANSINIT 

indicates that intrapartition queues are to be supported 
with the automatic task initiation feature. 

For further information on intrapartition data queues, 
refer to the appropriate CICS/VS Application Programmer's 
Reference Manual. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 


FORCE 

forces generation of all Stage 2 jobs for this program. 
Note ; Stage 2 jobs will always be produced for this program. 


SUFFIX^xx 

provides a one- or two-character suffix (other than NO or DY 
which are reserved) for the transient data control program 
being assembled. If this operand is omitted, a suffix is not 
provided. 


XINPUT=symbolic-name 

generates linkage in the transient data control program to a 
user-written exit routine. The linkage is provided before the 
acquisition of data in response to an input request. This exit 
is for intrapartition destinations only. For further 
information concerning user exits, see "User Exits for CICS/VS 
Management Programs" in Chapter 6.2 of this manual. 


XOUTPUT=symbolic-name 

generates linkage in the transient data control program to a 
user-written exit routine. The linkage is provided after 
locating the appropriate entry in the destination control table 
(DCT) but prior to writing data in response to an output 
request. This exit is for intrapartition destinations only. 

For further information concerning user exits, see "User Exits 
for CICS/VS Management Programs." 


XTYPREQ=symbolic-name 

generates linkage in the transient data control program to a 
user-written exit routine. The linkage is provided prior to 
determining what type of request for transient data services 
was issued. For further information concerning user exits, see 
"User Exits for CICS/VS Management Programs." 
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TRP 


TRACE CONTROL PROGRAM 


The trace control program (DFHSG PROGRAM=TRP) is used for program 
maintenance and performance tuning. Used in conjunction with the trace 
utility program, this feature provides for easy use of CICS/VS trace 
facilities. 





PR0GRAM= TRP 
[,AUX={NO|YES}] 
t f DUMMY=YES3 

[,STAGE2={SELECTIVE|FORCE}] 
[ f SUFFIX=xx] 

For DOS/VS only 

[,DEVADDR={ 0 0 9 1nnn>] 

C,DEVICE={TAPE|2314|3330|3340|3350}] 


PROGRAM=TRP 

indicates that the trace control program is to be generated. 


AUX-NQI YES 

specifies whether the optional feature of writing CICS/VS trace 
entries on a QSAM data set is to be generated. The default is 
AUX=NO. 

NO 

indicates that support for writing trace entries is not to 
be included. 


YES 

indicates that support for writing trace entries is to be 
included in addition to support for a main storage trace 
table. 


DUMMY=YES 

specifies that a dummy trace control program is to be 
generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : Stage 2 jobs for this program will always be produced in 

CICS/DOS/VS. 
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SUFFIX=XX 


provides a one- or two-character alphanumeric suffix (other 
than DY which is reserved) for the trace control program being 
assembled. If this operand is omitted, a suffix is not 
provided. 


For CICS/DQS/VS only 


DEVADDR=nnn 

specifies, for DEVICE=TAPE only, the DOS/VS device address to 
be assigned to the tape drive. It should be a three-digit 
decimal number with leading zeros, if necessary. For example, 
if SYS008 is the device address to be used, DEVADDR=008 must be 
specified. The default is DEVADDR=009. If the DEVICE=2314, 
3330, or 3340 operand is used, the DEVADDR value is picked up 
from the label information supplied for the auxiliary trace 
data set. 


DEVICE-device 

specifies the type of output device. A particular trace 
control program in CICS/DOS/VS will support only one type of 
output device. If different device types are to be used on 
different runs, more than one trace control program must be 
generated using the SUFFIX operand. The default is 
DEVICE=TAPE. 


TSP — TEMPORARY STORAGE CONTROL PROGRAM 

The system generation macro instruction necessary to generate the 
temporary storage control program is DFHSG PROGRAM=TSP. Unless 
otherwise indicated, the omission of an operand results in the 
corresponding function not being included. 

Note : The temporary storage program must be generated if the interval 

control program is used to store data. 


[ [dFHSG [ PROGRAM=TSP 1 


j j j [,AUX={YES|NO1REC>] j 
| | j [,DUMMY“YES] | 
| | j [,STAGE2={SELECTIVE|FORCE}] | 
j | j [,SUFFIX=xx] j 
| | j (,XINPUT=symbolic-name] j 
j | j [,XOUTPUT=symbolic-name] | 
| j j [,XTYPREQ=symbolic-name] j 

L-L-L-j 


PROGRAM=TSP 

indicates that the temporary storage control program is to be 
generated. 


AUX=YES|NO|REC 

specifies whether auxiliary storage is to be supported. The 
default is AUX=YES. The AUX=NO option can be useful for 
generating a development or test system. It provides an 
operational convenience by eliminating the need to define data 
space and data sets for temporary storage. 
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YES 


indicates that auxiliary storage support is to be 
generated. 

NO 

indicates that no auxiliary storage support is to be 
generated and that temporary store write requests will 
store data in main storage regardless of the STORFAC 
parameter specified in the user'*s request. AUX=NO must be 
specified if VSAM=NO was specified in the DFHSG 
TYPE=INITIAL macro. 


REC 

indicates that auxiliary storage support is to be generated 
and that certain auxiliary temporary storage identifiers, 
as defined in the temporary storage table (TST), will be 
recoverable. That is, they will be restored by the 
emergency restart and dynamic transaction backout functions 
in the event of a transaction or system failure. 


DUMMY=YES 

specifies that a dummy temporary storage program is to be 
generated. 

This operand may be used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy temporary storage control 
program. Any other operands which may have been included in 
the DFHSG PROGRAM=TSP macro instruction are ignored. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 


SUFFIX=xx 

provides a one- or two-character suffix (other than NO or DY 
which are reserved) for the temporary storage program being 
assembled. If this operand is omitted, a suffix is not 
provided. 


XINPUT=symbolic-name 

generates linkage in the temporary storage control program to a 
user-written exit routine. The linkage is provided prior to 
the return of control to the application program after 
servicing an input request. For further information concerning 
user exits, see "User Exits for CICS/VS Management Programs" in 
Chapter 6.2 of this manual. 
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XOUTPUT= symbolic-name 

generates linkage in the temporary storage control program to a 
user-written exit routine* The linkage is provided prior to 
writing data in response to an output request. For further 
information concerning user exits, see "User Exits for CICS/VS 
Management Programs." 


XTYPREQ=symbolic-name 

generates linkage in the temporary storage control program to a 
user-written exit routine. The linkage is provided prior to 
determining what type of request for temporary storage services 
was issued. For further information concerning user exits, see 
"User Exits for CICS/VS Management Programs." 


TERMINATION -- DFHSG TYPE=FINAL 


Stage 1 is terminated in response to the DFHSG TYPE=FINAL macro 
instruction. This macro instruction must be the last statement of the 
system generation input stream preceding the assembler END card. The 
assembler END statement does not require an operand. 

r- r - r - 1 

j |DFHSG j TYPE=FINAL | 

L_L_L_J 


TYPE=FINAL 

indicates the end of CICS/VS stage 1 system generation. 
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Chapter 2.3. Generating Recovery/Restart Support 


The generation of Recovery/Restart support in CICS/VS can be divided 
into the following functions: 

• Handling telecommunications errors 

• Handling program checks in application programs 

• Handling operating system abends 

• The CICS/VS warm restart mechanism 

• The CICS/VS dynamic transaction backout facility, 

• The CICS/VS emergency restart mechanism 

The CICS/VS System/Application Design Guide discusses the various 
functions of recovery/restart in detail. This section describes the 
actions necessary in the system generation process to take advantage of 
these facilities. Certain specifications also need to be made during 
preparation of the system tables. These are described in Chapter 3.3 of 
this manual. - 


TELECOMMUNICATIONS ERRORS 


DFHSG PROGRAM=RS P should be specified to generate the resend program if 
support for logical units is included in the system. RESEND=YES must be 
specified in this macro if the resending of messages (which were not 
transmitted successfully because of a line failure) is required. The 
above operand must also be specified if 3614s are attached to the 
CICS/VS system. 


PROGRAM CHECKS IN APPLICATION PROGRAMS 


DFHSG PROGRAM= SRP should be specified to generate the system recovery 
program if CICS/VS is to intercept program checks and abend the 
transactions which caused them on a selective basis. 


OPERATING SYSTEM ABENDS 


DFHSG PROGRAM=SRP must be specified to generate the system recovery 
program if CICS/VS is to intercept operating system abends, and either 
attempt recovery or terminate CICS/VS in as orderly a manner as 
possible. 
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CICS/VS WARM RESTART 


DFHSG PROGRAM=KPP should be specified to generate the keypoint program 
if the CICS/VS warm restart facility is to be used. It is not necessary 
to specify AKP=YES in this macro if the emergency restart facility is 
not required. 


CICS/VS DYNAMIC TRANSACTION BACKQUT 


The following specifications must be made if the automatic backout of 
changes made to CICS/VS protected resources by transactions which 
subsequently fail is required: 

• The dynamic transaction backout program (DFHSG PROGRAM=DBP) must be 
generated. 

• AUTOJRN=YES must be specified in the file control program (DFHSG 
PROGRAM=FCP) if backout of CICS/VS recoverable files is required. 

• AUTOJRN=YES and DTB=AUX or MAIN must be specified in the journal 
control program (DFHSG PROGRAM=JCP). 

• If backout of recoverable transient data destinations is required, 
DESTRCV=YES should be specified in the transient data program 
(DFHSG PROGRAM=TDP)• 

• If backout of recoverable auxiliary temporary storage identifiers 
is required, AUX=REC should be specified in the temporary storage 
program (DFHSG PROGRAM=TSP). 


CICS/VS EMERGENCY RESTART 


The following specifications should be made if the CICS/VS emergency 
restart facility is required: 

• BMSRCVR=YES must be specified in the basic mapping support program 
(DFHSG PROGRAM=BMS) if recovery of BMS messages is required. 

• AUTOJRN=YES must be specified in DFHSG PROGRAM^FCP if backout of 
CICS/VS recoverable files is required. 

• AUTOJRN=YES must be specified in DFHSG PROGRAM=JCP. 

• DESTRCV=YES must be specified in DFHSG PROGRAM=TDP if backout of 
recoverable transient data destinations is required. 

• AUX=REC must be specified in DFHSG PROGRAM=TSP if backout of 
recoverable auxiliary temporary storage identifiers is required. 

• RESEND=YES must be specified in DFHSG PROGRAM=RSP if re¬ 
presentation of committed output messages to logical units is 
required. 

• AKP=YES must be specified in DFHSG PROGRAM=KPP. 

• The transaction backout program (DFHSG PROGRAM=TBP) must be 
generated. 
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Chapter 2.4. Generating DL/I Facilities 


This chapter summarizes points which the system programmer must bear in 
mind when generating a CICS/VS system with DL/I facilities. The 
requirements for CICS/DOS/VS and CICS/OS/VS are discussed separately. 


| DL/I WITH CICS/DOS/VS 


Generation of DL/I support for CICS/DOS/VS systems requires the 
following steps: 

• The DL/I DOS/VS online system must be generated as described in the 
DL/I DOS/VS Utilities and Guide For The System Programmer manual. 

• CICS/DOS/VS must be generated with DL/I support as follows: 

DFHSG TYPE=INITIAL must include DLI (or DL1)=YES. 

The journal control program (DFHSG PROGRAM=JCP) must be 
generated if DL/I logging is to be performed on the CICS/DOS/VS 
system log rather than on the DL/I DOS/VS log. 

• DL/I data bases and application programs must be defined during the 
preparation of CICS/VS tables. Refer to Chapter 3.3 of this manual 
for further information. 


| DL/I WITH CICS/OS/VS 


Generation of DL/I support for CICS/OS/VS systems requires the following 
steps: 

• An IMS/VS Data Base System must be generated as described in the 

I IMS/VS Version 1 System Programming Reference Manual . 

• CICS/OS/VS must be generated with DL/I support as described below. 

• The required CICS/VS system tables must be generated as described 
in Chapter 3.2 of this manual. 

The specifications required for generating DL/I support in CICS/OS/VS 
are: 

• DFHSG TYPE= INITIAL must specify the level of the IMS/VS Data Base 

| System to be used. DL/I=1.1.4 or later is the only valid 

j specification for CICS/VS Version 1, Release 4. 

Notes : 

(1) DLI or DLI may be specified. 

(2) If a new release of IMS/VS is installed, it may be 
necessary to reassemble the CICS/VS DL/I modules DFHDLI and 

| DFHDLQ. DFHDBP and DFHTBP may also need to be reassambled. 
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• The journal control program (DFHSG PROGRAM=JCP) must be generated. 

All DL/I log records are written to the CICS/VS system log. 

The following macros and operands must be specified during the system 
generation process to provide DL/I shared data base support in 
CICS/OS/VS: 

• DFHSG PROGRAM=ISC with IRCSVC=number 

• DFHSG PROGRAM= TCP with ACCMETH=IRC 

In addition, DFHSG PROGRAM=CSO must be generated if any type of DL/I 
support is required in CICS/OS/VS. 

Information on the system table macros and operands that must be 
specified to provide DL/I shared data base support can be found in 
Chapter 3.4. 
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Part 3: Table Preparation 




Chapter 3.1. Introduction 


CICS/VS depends upon user-created system tables, which describe the 
user's data base/data communications environment and the treatment to be 
given to the elements of that environment. Contained in the system 
tables is information on terminals, data sets (permanent and temporary), 
programs, and transactions. These tables are created independently of 
system generation. However, they are required for the system to be 
operational. 

CICS/VS is configured under user control during system 
initialization. The desired system tables are selected by the user, 
using standard naming and suffixing conventions described below. Each 
of the tables is created separately and may be recreated at any time 
prior to system initialization. More than one system table of each type 
can be maintained at the same time. This allows the user to maintain 
special tables for testing in addition to the operational tables. 

Of these tables, the program control table (DFHPCT), the processing 
program table (DFHPPT), the system initialization table (DFHSIT), and 
the terminal control table (DFHTCT) must be generated. The other tables 
are only needed if the corresponding CICS/VS facilities are to be used. 

The tables are named in the following manner: 


Table 

Name 

Application load table 

DFHALTxx 

Destination control table 

DFHDCTxx 

File control table 

DFHFCTxx 

Journal control table 

DFHJCTxx 

Nucleus load table 

DFHNLTxx 

Program control table 

DFHPCTxx 

Program list table 

DFHPLTxx 

Processing program table 

DFHPPTxx 

System initialization table 

DFHSITxx 

Sign-on table 

DFHSNT 

System recovery table 

DFHSRTxx 

Terminal control table 

DFHTCTxx 

Terminal list table 

DFHTLTxx 

Temporary storage table 

DFHTSTxx 

Transaction list table 

DFHXLTxx 


The first six characters of the name are standard for each of the 
tables. Except for the sign-on table, the last two characters (xx) may 
be specified by the user through the SUFFIX operand to allow several 
versions of a table to be maintained; any one or two characters (other 
than NO) are valid. The suffix that the user assigns to a table is used 
to determine which version of that table is to be loaded into the system 
during system initialization. 

The system tables are prepared (generated) by assembling the 
appropriate macro instruction with its associated operands. For a 
description of the symbols and format used in CICS/VS macro 
instructions, see Chapter 1.1. 

The output of each macro instruction assembly contains the required 
linkage editor control statements. 
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CICS/VS will automatically generate the address of the entry point of 
each table through the DFHVM macro that is generated from each 
TYPE=INITIAL macro. 

See the appropriate CICS/VS System Programmers Guide for details 
concerning the assembly and link-editing of the tables. 

A description of the macro instructions for each of the system tables 
follows in Chapter 3.2. 

Chapters 3.3 and 3.4 contain information on how to provide the 
recovery/restart and DL/I facilities in CICS/VS system tables. This 
information should be used in conjunction with the equivalent system 
generation information in Chapters 2.3 and 2.4. 

The CICS/VS system table macro instructions in Chapter 3.2 are 
arranged in alphabetic order by table acronym. The elements of each 
table, however, are presented in a logical order because an alphabetic 
ordering would disrupt the rationale behind the structure of each macro. 
Thus, most of the table preparation macros are presented in the 
following manner: 

• DFHxxx TYPE=INITIAL 

• DFHxxx TYPE=ENTRY 

• DFHxxx TYPE=FINAL. 

All CICS/VS tables (except DFHSIT) must have TYPE=INITIAL and 
TYPE=FINAL as the first and last macros to be coded. 

Some tables, however, have a more complex structure. Two examples of 
this are the file control table (DFHFCT) and the terminal control table 
(DFHTCT). The introductory paragraphs to each such macro describe its 
structure. 

The operands within each macro are listed in the manner described in 
Chapter 1.1. However, in the case of certain parts of the file control 
table, the program control table, and the terminal control table, the 
optional operands are presented alphabetically on an access method basis 
in the syntax display. 

The discussion of each table (with the exception of DFHALT and 
DFHSIT) is concluded by an example of the coding for a typical table. 

Note : The STARTER=YES parameter is an internal operand, which is 

reserved for use by IBM. It is documented here for reasons of 
completeness and clarity only. 


96 


CICS/VS System Programmers Reference Manual 




Chapter 3.2. Table Preparation 


| This chapter contains information on the macros and operands that are 
| used to generate the CICS/VS system tables. The tables are presented 
j in alphabetic order of table acronyms. 


ALT -- APPLICATION LOAD TABLE 


The application load table enables the user to use virtual storage 
efficiently. It allows the user to control the order of loading 
application programs at system initialization. 

The application load table is an optional feature, and if not used, 
application programs will be loaded in an order dependent on parameters 
in the processing program table (PPT). If the application load table is 
used, the application programs specified in the table will be loaded 
first. Any programs in the PPT specified as permanently resident but 
not specified in the ALT will be loaded with the options specified in 
the PPT. 


CONTROL SECTION — DFHALT TYPE=INITIAL 


The control section for the application load table is established by the 
DFHALT TYPE=INITIAL macro instruction. 


f | DFHALT | TYPE=INITIAL ] 

j | | (,SUFFIX=XXJ | 


TYPE=INITIAL 

establishes the control section into which the application load 
table is assembled, and produces the necessary linkage-editor 
control cards. 


SUFFIX=XX 

specifies the suffix (one or two characters) for the 
application load table. This suffix will be appended to the 
basic name (DFHALT) and used to name the module on the linkage- 
editor output library. 


PROGRAM LOAD SEQUENCE — DFHALT TYPE=ENTRY 

The DFHALT TYPE=ENTRY macro instruction is used to add entries to the 
application load table. 
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| DFHALT 

1 

| TYPE=ENTRY 
j , PROGRAM 25 (name, name) 



1 

1 

1 

1 

i 

j [ f ALIGN={NO|YES|ENTRY!! 

1 [.CLASS={SPECIFIC IGENERIC!1 

j I,FIX=tNO|YES!! 
j [,PAGEOUT={NO|YES!] 



» 

I 

1 For DOS/VS Only 


L- 

1 

1 

1 

j [,ADRSPCE={HIGH|LOW!3 

-- - --J 


TYPE=ENTRY 

indicates that an entry is to be added to the application load 
table. 


| PROGRAM 25 prog ram-name 

specifies the program name(s) to be added to the application 
load table (multiple names may be specified and one entry will 
be created for each name). 


ALIGN=NO|YES|ENTRY 

specifies whether the programs are to be page aligned. The 
default is NO. 

NO 

specifies no page alignment. 

YES 

specifies that the module will be loaded on a page 
boundary. When ADRSPCE=HIGH (DOS/VS only) is specified or 
defaulted in this macro, the end of the program will be 
| aligned on a page boundary. For ADRSPCE=LOW and for 

j CICS/OS/VS, the beginning of the program will be page- 

aligned. 

ENTRY 

specifies that the entry point of the module will be loaded 
on a page boundary. This is useful when the working set of 
the module follows the module entry point and the entry 
point is not at the start of the module. In CICS/DOS/VS, 
ALIGN=ENTRY may only be used when ADRSPCE=LOW is specified. 


| CLASS=GENERICj SPECIFIC 

specifies whether the program names in this entry are to be 
treated as specific program names or generic program names. 

The default is SPECIFIC. 

GENERIC 

causes all programs in the processing program table with 
names beginning with the characters specified by this 
application load table entry to be loaded, by the sequence 
in the PPT, with the options specified by this entry. 

SPECIFIC 

| causes the individual program in the processing program 

j table with the name specified by this application load 

j table entry to be loaded with the options specified by this 

j entry. 
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I FIX=NO|YES 

specifies whether the programs are to be page fixed. The 
default is NO. 

NO 

indicates that page fixing is not required. 

YES 

| indicates that pages are to be page fixed. If this option 

( is specified in OS/VS, the appropriate SVC routine must be 

| generated in the operating system. 


| PAGEOUT=YES|NO 

j specifies whether CICS/VS is to force the program(s) out of 

j real storage when not in use, and subsequently force the page 

j that contains the program entry point in when the program is 

needed. The default is NO. 

YES 

indicates that page-out and page-in operations should be 
performed for this program. PAGEOUT=YES also causes page 
alignment of the program, to ensure that other programs are 
not inadvertently affected by the page-out request. 

However, if the next entry in the application load table is 
not page-aligned, it may be totally or partially included 
in the page-out of the previous program. If this option is 
specified in OS/VS, the appropriate SVC routine must be 
generated in the operating system. 

NO 

indicates that no paging operations are to be performed. 



For DOS/VS onl\ 


| ADRSPCE= HIGH 1 LOW 

specifies whether the program is to be loaded in high address 
space or low address space within the virtual partition. The 
end of the program will be page-aligned when ADRSPCE=HIGH is 
specified. The default is HIGH. 


END OF APPLICATION LOAD TABLE — DFHALT TYPE=FINAL 


The end of the application load table is indicated by the DFHALT 
TYPE=FINAL macro instruction. This is the last statement in the 
assembly of the application load table before the assembler END 
statement. 


(DFHALT | TYPE=FINAL 


TYPE=FINAL 

specifies that this is the last entry to be accepted by this 
application load table. This entry will also generate a dummy 
entry to be used as an end-of-table indicator. 
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DCT 


DESTINATION CONTROL TABLE 


The destination control table (DFHDCT) is used to describe to CICS/VS 
the destination name and certain other characteristics of data that is 
transient to CICS/VS (that is, to be processed by the transient data 
control program) and which can be queued. Entries are made to the DCT 
by generating the destination control table macro instruction (DFHDCT). 

The following macro instructions are available to define the 
destination control table entries: 

• DFHDCT TYPE=INITIAL, which establishes the control section 

• DFHDCT TYPE=EXTRA, which specifies extrapartition destinations 

• DFHDCT TYPE=INDIRECT, which specifies indirect data destinations 

• DFHDCT TYPE=INTRA, which specifies intrapartition destinations 

• DFHDCT TYPE=REMOTE, which describes remote transient data 
destinations in an intersystem communication session 

• DFHDCT TYPE=SDSCI, which specifies the data set control information 

• DFHDCT TYPE=FINAL, which concludes the entries for the destination 
control table. 

Sequential extrapartition destinations are used for storing data 
external to the CICS/VS partition/region or for retrieving data from 
outside the partition/region. Data stored for this purpose includes 
data received from terminals or data created internally as the result of 
some transaction requirement identified by a user-written program. 

Extrapartition data may be both input and output data and is processed 
using QSAM under CICS/OS/VS or SAM under CICS/DOS/VS. It may also, for 
example, be a printer destination such as SYSLST in CICS/DOS/VS. 

Destination control table macro instructions are also used to specify 
intrapartition destinations. A single data set is used to hold the data 
for all intrapartition destinations. Intrapartition data may be 
ultimately either transmitted upon request to a destination terminal or 
retrieved sequentially from the intermediate data set for other uses. 

The user can specify, through the destination control table, that a task 
is to be created when a certain number of records (the "trigger level") 
has been accumulated for an intrapartition destination. 

The intrapartition destination may be defined as being either 
logically or physically recoverable. Logically recoverable destinations 
are recovered after an individual transaction or after total system 
failure, to the status they had at the start of the transaction which 
was processing them when the failure occurred. Physically recoverable 
destinations are recovered, after a total system failure, to the status 
they had when the system failure occurred. 

Included in the destination control table is the appropriate user- 
prepared data set control information for all resident extrapartition 
data sets. This data set control information must follow the DFHDCT 
TYPE=INITIAL macro instruction. The extrapartition data sets supported 
under CICS/VS ares blocked or unblocked, fixed or variable-length. 

CICS/VS allows, in conjunction with the dynamic open/close facility, 
nonresident (transient) data set control blocks and associated 
input/output areas and logic modules. Main storage normally occupied by 
these storage areas is therefore available to the dynamic main storage 
area until the use of the storage areas is required. Nonresident data 
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set control blocks are defined through the combination of DFHDCT 
TYPE=INITIAL and DFHDCT TYPE=SDSCI macro instructions. 

Whether the specified destinations are extrapartition or 
intrapartition (or indirect destinations pointing to either 
extrapartition or intrapartition destinations), the symbolic names of 
the destinations must be provided by the user. CICS/VS uses several 
intrapartition destinations for its own purposes. These entries must be 
included in the generation of the DOT. Refer to Appendix A for details 
of the required entries. 


CONTROL SECTION — DFHDCT TYPE^INITIAL 


The entry point and beginning address for the destination control table 
being defined are established by the DFHDCT TYPE=INITIAL macro 
instruction. 



|DFHDCT 

| TYPE=INITIAL 



1 

1 

1 

1 

I 

j [,INDEX={NO|YES}] 

| [,SEPASMB= CNO|YES}] 

1 t,SUFFIX=XX] 
j [, TRNSUFX= (.xx (,xxl,...)] 

i 



1 

1 

1 

i 

1 For DOS/VS onlv 
» 



1 

i 

| (,DEVICE={2314|3330|3340|3350}] 



L-L---L_-_-_J 


TYPE=INITIAL 

establishes the control section into which the destination 
control table is assembled. 


| INDEX=NO1 YES 

j specifies whether indexing will be used. The default is NO. 

| In some circumstances, indexing reduces the number of processor 

cycles required to search CICS/VS tables by shortening the scan 
to locate entries. It also reduces the CICS/VS working set for 
large tables by reducing references to little-used or unused 
pages, or pages between the referenced entry and table start. 
For further information, refer to the appropriate CICS/VS 
System Programmers Guide. 

YES 

| indicates that indexing will be used. When this option is 

| chosen, an alphabetically ordered list of destination names 

j is generated as part of the expansion of the DFHDCT 

j TYPE=FINAL macro. 


NO 

| indicates that indexing will not be used. 

I Note : Page-indexing (the former PAGENXD operand) is no longer 

| supported. However, if PAGENXD=YES is specified and the INDEX 

| operand does not appear, the entries will be treated as if 

j INDEX=YES were specified. 
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SEPASMB=NO|YES 

indicates whether a full destination control table is to be 
generated or whether only data set control information for 
nonresident data set definition is to be generated. The 
default is SEPASMB=NO 

NO 

indicates that a full destination control table is to be 
generated with data set control information. 

YES 

indicates that only the DFHDCT TYPE=INITIAL, DFHDCT 
TYPE=SDSCI, and DFHDCT TYPE=FINAL macro instructions are 
are to be included in this destination control table. This 
option does not generate a full destination control table. 
For further information on the use of the SEPASMB=YES 
option, refer to the section on "Nonresident Data Set 
Definition" at the end of the description of the 
destination control table. 


SUFFIX=xx 

specifies a one- or two-character alphanumeric suffix (other 
than "NO" which is reserved) for the destination control table 
being assembled. This suffix, if specified, is appended to the 
standard module name (DFHDCT) and is used to name the module on 
the linkage editor output library. If this operand is omitted, 
a suffix is not provided. 


TRNSUFX=xx 

specifies a list of one- or two-character alphanumeric suffixes 
associated with nonresident data set control blocks. Any 
suffix appearing subsequently in the SUFFIX operand of the 
DFHDCT TYPE=SDSCI macro instruction must also appear in this 
list. These suffixes are used to punch the control cards for 
the linkage-editor (LNKEDT). Up to 255 suffixes can be 
specified. 

Note : During link-edit of DFHDCT, there is one unresolved 

ADCON in each phase created under the direction of TRNSUFX in 
DFHDCT TYPE=INITIAL. This message does not imply an error. 


For DOS/VS Only 


DEVICE=device 

specifies the type of device on which the DAM intrapartition 
data set resides. The default is DEVICE=2314. This operand 
replaces the DEVICE operand that was formerly in DFHSG 
PROGRAM=TDP. 


EXTRAPARTITION DESTINATIONS — DFHDCT TYPE=EXTRA 


Destinations external to the CICS/VS system (but which are allocated to 
CICS/VS) are specified in the DFHDCT TYPE=EXTRA macro instruction. This 
macro instruction must be generated once for every extrapartition 
destination. 
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Destinations that are not allocated to this CICS/VSsystem but which 
are required for access by this CICS/VS system in an intersystem 
communication session are defined to be in another CICS/VS system 
through the DFHDCT TYPE=REMOTE macro, which appears later in the 
discussion of this table. 

Extrapartition destinations which use nonresident data set control 
blocks are not required to be associated with a specific data set 
definition. When such destinations are opened, a one- or two-character 
suffix must be supplied to the dynamic open/close program that indicates 
which nonresident data set control blocks are to be used for the 
destinations. 

Notes : 

1. The DFHDCT TYPE=INDIRECT macro instruction should be used when 
multiple extrapartition destinations are directed to the same data 
set. 

2. Any destination identification (DESTID) of more than four 
characters is truncated on the right. The name should not start 
with the letter "C", which is reserved for CICS/VS. This applies 
to DFHDCT TYPE=EXTRA, TYPE=INDIRECT, and TYPE=INTRA• Refer to 
Appendix A for a listing of the required destination identification 
entries. 


r-r-r-1 



|DFHDCT 

| TYPE=EXTRA 



i 

j ,DESTID=name 



i 

j [,DSCNAME=name] 



i 

1 C,OPEN={INITIALIDEFERRED}] 


l - 

i 

_ L 

j [ ,RESIDNT={YES J NO}] 



TYPE=EXTRA 

indicates extrapartition destinations. 


DESTID=name 

specifies the symbolic name of the extrapartition destination. 
The symbolic name is the same as that used in the transient 
| data operations to specify the destination. 


DSCNAME=name 

specifies the data set name the user must include in the DFHDCT 
TYPE=SDSCI macro instruction for destinations that use resident 
data set control blocks. This operand is not applicable for 
destinations that use nonresident data set control blocks. 
Nonresident data set control blocks are identified when the 
destination is opened. 


| OPEN=INITIAL|DEFERRED 

specifies how the data set associated with this destination is 
to be opened. The default is OPEN=INITIAL. This operand 
applies only to extrapartition destinations which use resident 
data set control blocks. 

INITIAL 

indicates that the data set is to be opened during system 
initialization. 
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DEFERRED 

indicates that the user will open the data set during 
execution of CICS/VS. 


| RESIDNT=YES|NO 

indicates whether this destination is to use resident or 
nonresident data set control blocks. The default is 
RESIDNT=YES. 

YES 

indicates resident data set control blocks. 

NO 

indicates nonresident data set control blocks. 

Those CICS/DOS/VS extrapartition data sets which are closed and 
reopened by the dynamic open/close function of the master 
terminal program must be defined as nonresident, or 
unpredictable results may occur. See "Nonresident 
Extrapartition Data Set Definition" below. 


INDIRECT DATA DESTINATIONS ~ DFHDCT TYPE=INDIRECT 


Indirect data destinations can be specified within the destination 
control table using the DFHDCT TYPE=INDIRECT macro instruction. The 
indirect data destination does not point to an actual data set but 
instead points to another destination. 

For example, assume that the user develops functional symbolic names 
for the destinations of several message types. These, in turn, may 
point to one actual destination. At a later time the user might choose 
to direct one of the message types to another destination. The user 
| does not change the programs but only alters the indirect destination 
name. 


r - r - r - 

j (DFHDCT | TYPE=INDIRECT 

| | | ,DESTID=name 

j j | ,INDDEST=name 

L-l- l - 


’i 

I 


j 


TYPE=INDIRECT 

indicates an indirect destination. 


DESTID=name 

specifies the four-character symbolic name of a particular 
indirect destination. The symbolic name is the same as that 
used in the transient data operation. 


INDDEST=name 

specifies the symbolic identification of an intrapartition or 
extrapartition destination. This identification must be the 
same as the DESTID of the actual destination. If the name 
specified is not defined in the DCT, an assembly error will 
result. 
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INTRAPARTITION DESTINATIONS — DFHDCT TYPE=INTRA 


Destinations for messages that are to be logged temporarily by CICS/VS 
are specified using the DFHDCT TYPE=INTRA macro instruction. This macro 
instruction must be specified once for every intrapartition destination. 



|DFHDCT 

| TYPE=INTRA 



i 

j ,DESTID=name 



i 

1 [.DESTFAC=(TERMINAL|FILE}J 



i 

j {,DESTRCV=(NO|PH|LG}] 



i 

j {,REUSE={YES|NO}J 



i 

j [,TRANSID=name] 


L- 

i 

L__ - 

j { f TRIGLEV={11 number}] 

. i— _ _ ____ _ _ _ 

__ J 


TYPE=INTRA 

indicates an intrapartition destination. 


DESTID=name 

specifies the symbolic name of the intrapartition destination. 
The symbolic name is the same as that used in the transient 
| data operation to specify the destination. 

If the ultimate destination of the data is a terminal and if 
automatic task initiation is associated with the destination, 
the name specified in the DESTID operand must be the same as 
the name specified in the TRMIDNT operand of the DFHTCT 
TYPE=TERMINAL macro instruction. The user may find it 
convenient to use the same naming convention for terminal 
destinations and data set destinations, regardless of whether 
automatic task initiation is requested. 


| DESTFAC- TERMINAL I FILE 

specifies the type of destination that the queue represents. 
The default is DESTFAC=TERMINAL. 

TERMINAL 

indicates that the transient data destination is to be 
associated with a specific terminal. If the automatic 
initiation facility is used, as specified in the TRANSID 
and TRIGLEV operands, the transaction initiated will be 
associated with the specified terminal, which must be 
available before the transaction can be initiated. 


FILE 

indicates that the transient data destination is to be used 
as a file of data records which are not associated with a 
particular terminal. Automatic task initiation does not 
require a terminal to be available. 


| DBSTRCV-NO|PH|LG 

indicates the recoverability attributes of the destination in 
the event of an abnormal termination of CICS/VS. The default 
is DESTRCV=NO. 


indicates that this destination is not recoverable and that 
automatic logging is not to be performed to keep track of 
accesses to this destination. 
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PH 


indicates that this destination is physically recoverable 
and that automatic logging is to be performed to keep track 
of accesses by application programs. In the event of 
emergency restart, this destination is to be recovered to 
its status at the time CICS/VS terminated. 


LG 

indicates that this destination is logically recoverable 
and that automatic logging is to be performed to keep track 
of accesses by application programs. If a transaction 
which had accessed this destination was in-flight at the 
time of abnormal termination, in the subsequent emergency 
restart or dynamic transaction backout this destination is 
to be restored to the status it would have had if the in¬ 
flight transaction had not modified it. 

Notes : 

1. If the destination is specified with REUSE=YES and 

DESTRCV= NO, a track is released as soon as the last record 
on it has been read. 

2. When REUSE=YES and DESTRCV=PH are specified for a 
destination, a track is released during the next GET after 
the GET which read the last record. 

3. For REUSE=YES and DESRCV=LG, a track is not released until 
the end of the task, or until after the next user-specified 
sync point. 

4. If DESTRCV=LG is specified, when this destination is 
accessed, the record being read or written will be enqueued 
upon. This enqueue will be maintained until the task 
terminates or issues a DFHSP macro to signal the end of a 
logical unit of work. This is necessary to ensure the 
integrity of the data being accessed. Because the enqueues 
are thus maintained for a longer period of time, the 
potential for an enqueue lockout exists if an application 
program that accesses this destination performs what is 
effectively more than one logical unit of work against it 
without defining each separate logical unit of work to 
CICS/VS by issuing the sync point request. Furthermore, 
when a PURGE request is issued for a logically recoverable 
queue, the input and output ends of the queue are enqueued 
upon. This increases the probability of an enequeue 
lockout. 


REUSE=YES|NO 

specifies whether the storage tracks are to be reused. The 
default is REUSE=YES. 

YES 

indicates that intrapartition storage tracks for this 
destination are to be released after they have been read, 
and returned to the pool of available tracks after the 
logical unit of work which read them has terminated. 

NO 

indicates that intrapartition storage tracks for this 
destination are not to be released until a transient data 
delete request is issued; this causes all tracks associated 
with this DESTID to be released. 
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TRANSID=name 

provides identification for the transaction that is to be 
automatically initiated when the trigger level is reached. The 
purpose of such initiated transactions is to read records from 
the destination. If this operand is omitted, or if TRIGLEV=0 
is specified, some other means must be employed to schedule 
transactions to read records from the destinations. 


TRIGLEV=number 

specifies the number of data records (the "trigger level") to 
be accumulated for a destination before automatically 
requesting the creation of a task to process these records. If 
the TRANSID operand has been used, and if no trigger level has 
been specified, TRIGLEV defaults to a value of 1. The maximum 
which may be specified is 32767. (If the destination is a 2741 
Communication terminal, the task to be initiated is not 
initiated until that terminal receives data.) 

If the DESTFAC operand specifies TERMINAL, the transaction will 
not be initiated until the associated terminal (with the same 
name as that specified in DESTID) is available; the terminal 
will be connected to the initiated transaction. If the DESTFAC 
operand specifies FILE, no terminal is necessary for the 
| transaction to be initiated. If the execution of a transient 

| data write request results in the trigger level being reached 

(or exceeded) for a non-terminal destination, and if either a 
"maximum tasks" or "short-on-storage" condition exists for 
CICS/VS, the task to be automatically initiated is not 
| initiated until a subsequent write request to the same 

destination occurs with the stress condition no longer 
existing. 

During CICS/VS operation the trigger level can be changed by 
means of the CSMT transaction issued by the master terminal 
operator (see the CICS/VS Operators Guide ). If the trigger 
level is reduced to a number equal to or less than the number 
of records accumulated so far, the task will be initiated when 
the next record is put to the destination. 


| REMOTE TRANSIENT DATA DESTINATIONS — DFHDCT TYPE=REMOTE 


| Remote transient data destinations, which participate in intersystem 
| communication sessions, are described to the destination control table 
j by means of the DFHDCT TYP E= REMOTE macro. 

j f - r r -ti 



jDFHDCT j 

TYPE=REMOTE 



1 1 

,DESTID=name 



1 1 

,SYSIDNT=name 



1 1 

t,LENGTH=length] 



1 1 

(,RMTNAME=name] 



j l-1----- 


| TYPE=REMOTE 

j indicates that this DCT entry identifies a remote transient 

j data destination. 
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DESTID=name 

provides a four-character name by which the destination is 
known to application programs in the local system. 


SYSIDNT^name 

specifies the four-character name of the system in which the 
remote transient data destination resides. The name specified 
must be the same as that given in the SYSIDNT operand of the 
DFHTCT TYPE=ISLINK macro, or in an explicit remote request in 
an application program. 


LENGTH=length 

indicates the length in bytes of fixed records for a remote 
destination. The value specified must correspond to that 
specified for the DCT in the system where the destination 
resides. If a value is not specified for the LENGTH operand, 
the LENGTH parameter must be given in READQ or WRITEQ requests 
in the application program. 


RMTNAME=name 

indicates the name by which the destination is known in the 
system where that destination resides. If this operand is 
omitted (the normal case), the name specified in the DESTID 
operand is used. RMTNAME=name allows two destinations, with 
the same name but in different systems, to be referenced. 


DATA SET CONTROL INFORMATION — DFHDCT TYPE=SDSCI 

The data set control blocks (DTFs in CICS/DOS/VS; DCBs in CICS/OS/VS) 
are generated in response to the DFHDCT TYPE=SDSCI macro instruction. 
This macro instruction is only needed for extrapartition transient data 
and must have a DFHDCT TYPE=EXTRA macro instruction associated with it 
for resident data set control blocks. Note that all DFHDCT TYPE-SDSCI 
macro instructions must be issued immediately following the DFHDCT 
TYPE=INITIAL macro instruction and preceding any DFHDCT TYPE=EXTRA, 

| DFHDCT TYPE=INTRA, DFHDCT TYPE=INDIRECT, or DFHDCT TYPE=REMOTE macro 
| instructions. 



jDFHDCT 

| TYPE=SDSCI 



i 

| ,DSCNAME=name 



i 

i 

i 

i 

i 

j l,BLKSIZE=lengthl 
| ( , BUFNO={1|number}3 

1 I.ERROPT={IGNORE1 SKIP}] 

j t,RECFORM= CFIXUNB|FIXBLK|VARUNB|VARBLK}] 
j £,RECSIZE=length] 



i 

| [,REWIND={UNLOAD|NORWD|LEAVE|REREAD}] 

| £,SUFFIX=xx3 



i 

i 

1 £.TYPEFLE= £INPUTIOUTPUT1RDBACK}] 



1 

I 

1 For DOS/VS Only 



1 

i 

| , DEVICE=device 



i 

i 

| £,CTLCHR=£ YES|ASA}] 

j £,DEVADDR=symbolic-address] 



i 

| £,FILABL=£NO|STD}] 

| £,MODNAME=name3 
| £,TPMARK=NO] 


L — 
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TYPE=SDSCI 

specifies data set control information. 


DSCNAME=name 

specifies the data set control name. This name must be the 
same as that specified in the DSCNAME operand of any associated 
DFHDCT TYPE=EXTRA macro instruction and is limited to seven 
characters in CICS/DOS/VS or eight characters in CICS/OS/VS. 

For CICS/OS/VS, the name used for DSCNAME must be used as the 
ddname on the DD statement and will also be used as the name 
for the DCB which is created. In CICS/DOS/VS, this name should 
be the same as that specified on the DLBL system control 
statement. The name should not start with the letters "DFH", 
which are reserved for use by CICS/VS, unless it is describing 
one of the standard destinations listed in Appendix A. Use of 
the prefix "DFH" may cause assembly errors and future 
compatibility problems for the user, because the DSCNAME 
parameter becomes an externally specified name. 


BLKSIZE=length 

specifies the length (in bytes) of the block (the maximum 
length for variable length records including four bytes for 
LLbb). For DOS/VS disk output data sets, the eight bytes 
required by logical IOCS for creation of the count field should 
be added. For OS/VS, the length may also be specified in the 
DCB parameter or in the DSCB. 


BUFNO=number 

specifies the number of buffers to be provided. The default is 
BUFN0=1. For CICS/DOS/VS, any value other than 2 defaults to 
1. For CICS/OS/VS, any number up to 255 may be specified. 


| ERROPT= IGNORE I SKIP 

specifies the error option to be performed in the event of an 
I/O error. The default is ERROPT=IGNORE. 

IGNORE 

causes the block that caused the error to be accepted. 


SKIP 

causes the block that caused the error to be skipped. 


| RECFORM= record-format 

specifies the record format of the data set. 

FIXUNB 

indicates fixed unblocked records. 

FIXBLK 

indicates fixed blocked records. 

VARUNB 

indicates variable unblocked records. 

VARBLK 

indicates variable blocked records. 

For CICS/DOS/VS, the default is RECFORM=FIXUNB. For 
CICS/OS/VS, no default is provided; the record format specified 
in the data definition (DD) statement is used. 
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RECSIZE=length 

specifies the length (in bytes) of the record (the maximum 
length for variable length records including four bytes for 
LLbb)• For OS/VS, the length may also be specified in the DCB 
parameter or in the DSCB. For DOS/VS, RECSIZE=length need only 
be specified for RECF0RM=FIXBLK. 


| REW±ti!i>=UNLOAD | NORWD | LEAVE | REREAD 

indicates the disposition of a tape data set, 

UNLOAD 

indicates a rewind and unload of the current volume 
(CICS/DOS/VS only). 

NORWD 

indicates that the volume should not be rewound 
(CICS/DOS/VS only), 

LEAVE 

positions the current volume to the logical end of the data 
set (CICS/OS/VS only). 

REREAD 

positions the current volume to reprocess the data set 
(CICS/OS/VS only). 


SUFFIX-XX 

specifies a one- or two-character alphanumeric suffix for the 
nonresident data set control block being generated. The use of 
this operand indicates that the data set control block being 
generated is nonresident. Nonresident data set control blocks 
reside on the DOS/VS private or system core-image library or 
the OS/VS CICS•LOADLIB under the unique name DFHTRNxx, where 
"xx" is the suffix specified in this operand. The user- 
provided suffix characters must also be specified in the DFHDCT 
TYPE=INITIAL,TRNSUFX=(xx,...) list. In addition, the order of 
SUFFIX=xx operands specified in this macro must match that of 
the TRNSUFX specifications in DFHDCT TYPE=INITIAL, or 
unpredictable results will occur. 

For each data set control block generated using the DFHDCT 
TYPE—SDSCI,SUFFIX=xx macro instruction, the same suffixed name 
must be specified in the preparation of the program processing 
table (DFHPPT TYPE=ENTRY,PROGRAM=DFHTRNxx). 


j TYPE** LE^INPUT j OUTPUT | RDBACK 

specifies the type of data set. The default is TYPEFLE=INPUT. 
INPUT 

indicates an input data set. 

OUTPUT 

indicates an output data set. 

RDBACK 

indicates an input data set that is to be read backward. 

An extrapartition SDSCI can be either input or output, not 
both. System abend codes or unpredictable results may occur if 
output operations specify an input SDSCI or if input operations 
specify an output SDSCI. 
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For DOS/VS only 


DEVICE=device 

specifies the type of input/output device. Valid device types 
are: 1403 f 1404, 1443, 1445, 2314, 3203, 3211, 3330, 3340, 

| 3350, 5203, and TAPE, This operand is ignored in CICS/OS/VS; 

instead, the device specified through the data definition (DD) 
statement is used. 


| CTLCHR=character 

specifies the type of control character to be used for printer 
devices. The control character must be the first byte of the 
user-supplied record. It is not supplied by CICS/VS. The 
default is no control character. 


DEVADDR=symbolic-address 

specifies the symbolic unit address. This operand is not 
required for disk data sets when the symbolic address is 
provided through the CICS/DOS/VS EXTENT card. 


| FILABL=NO|STD 

specifies the type of label on tape data sets. The default is 
FILABL=NO. 

NO 

indicates that the tape data sets do not have standard 
labels. 

STD 

indicates that the tape data sets have standard labels. 


MODNAME=name 

specifies the name of the logic module to be used to process 
the transient data set. If this operand is omitted, a standard 
DOS/VS name is generated for calling the logic module. 

This operand can be used in conjunction with the DOS/VS 
subset/superset logic module facility to reduce the number of 
logic modules required to process sequential data sets (where 
supersetting is permissible). 


TPMARK=NO 

indicates that the writing of a tapemark at the beginning of a 
data set (file) is to be suppressed. When TPMARK=N0 is 
specified, FILABL=NO is required. 

For further information on the above operands, refer to DOS/VS 
Supervisor and I/O Macros or to OS/VS Data Management Macro 
Instructions. 
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END OF DESTINATION CONTROL TABLE 


DFHDCT TYPE=FINAL 


Entries for the destination control table are terminated by the DFHDCT 
TYPE=FINAL macro instruction. This macro instruction must be the last 
statement in the assembly of every destination control table before the 
assembler END statement. 


r-r-r----1 

j {DFHDCT | TYPE=FINAL j 


TYPE=FINAL 

indicates the end of the destination control table. 


NONRESIDENT EXTRAPARTITION DATA SET DEFINITION 

Nonresident extrapartition data sets are defined through the DFHDCT 
TYPE=INITIAL and DFHDCT TYPE=SDSCI macro instructions. The data set 
control blocks and associated input/output areas are generated and 
cataloged to the DOS/VS private or system core-image library or the 
OS/VS CICS•LOADLIB as a separate table for each nonresident data set 
control block to be used. There must be an entry in the processing 
program table (PPT) for each nonresident data set control block. The 
format of the name is DFHTRNxx, where "xx" represents the suffix 
character(s) specified in the DFHDCT TYPE=SDSCI, SUFFIX=xx macro 
instruction. The PPT entry for these data set control blocks must 
include the RELOAD=YES operand. 

In CICS/OS/VS , the necessary access methods are acquired when data 
sets are opened. Therefore, references to transient access methods 
(logic modules) in the following discussion are applicable primarily to 
CICS/DOS/VS. 

In CICS/DOS/VS, the logic modules for the nonresident data set 
control blocks may also be transient. If the use of nonresident logic 
modules is required, the logic modules must be assembled and cataloged 
to the DOS/VS private or system core-image library prior to execution. 
The logic modules are assembled using the standard DOS/VS SAM macro 
instructions and must be cataloged with the same program name generated 
by the nonresident data set control block for which it is to be used. 

The name can be found in the assembly of the data set control block. 
Unless otherwise specified in the DFHDCT TYPE=SDSCI macro instruction, 
this name is the standard DOS/VS logic module name. 

The PPT entry required for each nonresident logic module must include 
the RELOAD=YES operand. 

In CICS/DOS/VS, if the DCT is generated to include the nonresident 
data set control block definitions, the logic modules for both the 
resident and nonresident data set control blocks are link-edited into 
the DCT. To allow the logic modules to be transient, the DCT should be 
assembled including only the resident data set control block definitions 
(DFHDCT TYPE=SDSCI). A separate assembly can then be accomplished to 
generate only the nonresident data set control blocks. This requires a 
DFHDCT TYPE=INITIAL, TRNSUFX=(xx,...),SEPASMB=YES macro instruction, 
followed by DFHDCT TYPE=SDSCI macro instructions for all nonresident 
data set definitions, followed by the DFHDCT TYPE=FINAL macro 
instruction. 
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EXAMPLES 


| Figure 3.2-1 contains an example of the coding required to generate a 
destination control table that uses resident data set control blocks. 

DFHDCT TYPE=INITIAL START OF DESTINATION CONTROL TABLE * 


DEVICE=3340 

DFHDCT TYPE=SDSCI, SPECIFY DATA SET CONTROL INFO * 

DSCNAME=AAAXTRA, RELATED DESTINATION * 

DEVADDR=SYSLST, SYMBOLIC UNIT ADDRESS * 

DEVICE=140 3 , DEVICE TYPE * 

RECFORM= FIXUNB RECORD FORMAT 

DFHDCT TYPE=EXTRA, EXTRAPARTITION DESTINATION * 

DSCNAME=AAAXTRA , * 

DESTID=CASH SYMBOLIC NAME 

DFHDCT TYPE=INTRA, INTRAPARTITION DESTINATION * 

DESTID=GAMA SYMBOLIC NAME 

DFHDCT TYPE=INTRA, * 

DESTID=SAMA SYMBOLIC NAME 

DFHDCT TYPE=INTRA, * 

DESTID=DAMA, SYMBOLIC NAME * 

TRIGLEV= 5 , * 

DESTFAC=TERMINAL, * 

TRANSID=AUTO TRANSACTION ID 


DFHDCT TYPE=FINAL END OF DESTINATION CONTROL TABLE 

| END 

| Figure 3.2-1. DCT Using Resident Data Set Control Blocks 


Figures 3.2-2 and 3.2-3 show how the generation of a DCT can include 
extrapartition destinations that use nonresident data set control 
blocks. Figure 3.2-2 shows a DCT with nonresident data set control 
blocks and resident logic modules. Figure 3.2-3 shows a DCT with 
nonresident data set control blocks and nonresident logic modules. 

| The assembly of the macro instructions contained in Figure 3.2-2 
results in a destination control table with suffix of 22 (DFHDCT22) 
which contains one data set control block for the printer (TYPE=SDSCI, 
DSCNAME=PRINT)• When the output of this generation is link-edited, the 
logic modules for tape and printer are automatically included, and the 
four tape data set control blocks are cataloged separately to the DOS/VS 
private or system core image library or OS/VS CICS.LOADLIB as DFHTRNAA, 
DFHTRNBB, DFHTRNCC, and DFHTRNDD• 

The extrapartition destination (DESTID=TAPE) can be opened through 
the CICS/VS dynamic open/close program with any of the four suffixed 
data set control blocks (DFHTRNAA, DFHTRNBB, DFHTRNCC, or DFHTRNDD). It 
can then be closed and reopened with any of the other nonresident data 
set control blocks. 

Program processing table (PPT) entries must be included for the four 
data set control blocks cataloged separately. PPT entries must include 
the RELOAD=YES operand. 
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DFHDCT TYPE=INITIAL, * 

TRNSUFX= (AA,BB,CC,DD), * 

SUFFIX=22 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE1, * 

RECFORM=FIXBLK, * 

TYPEFLE=OUTPUT, * 

BLKSIZE=2000, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

BUFN0=2, * 

RECSIZE=200, * 

SUFFIX=AA 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE2, * 

RECFORM=FIXBLK, * 

TYPEFLE=INPUT, * 

BLKSIZE=2000, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

BUFN0=2, * 

RECSIZE=200, * 

SUFFIX=BB 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE3, * 

RECFORM=FIXUNB, * 

BLKSIZE=1240, * 

TYPEFLE=INPUT, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

SUFFIX=CC 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE4, * 

RECFORM= FIXUNB, * 

BLKSIZE=1240, * 

TYPEFLE= OUTP UT, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

SUFFIX=DD 

DFHDCT TYPE=SDSCI, * 

DSCNAME=PRINT, * 

RECFORM=VARUNB, * 

BLKSIZE = 121, * 

DEVADDR=SYSLST, * 

DEVICE=1403 

DFHDCT TYPE=EXTRA, * 

DSCNAME=PRINT, * 

DESTID=PRNT 

DFHDCT TYPE=EXTRA, * 

RESIDNT=NO, * 

DESTID=TAPE 

DFHDCT TYPE=FINAL 
| END 

| Figure 3.2-2. DCT Using Nonresident Data Set Control Blocks and 
Resident Logic Modules 
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DFHDCT TYPE=INITIAL, * 

TRNSUFX=(AA,BB,CC,DD), * 

SEPASMB=YES 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE1, * 

RECFORM=FIXBLK, * 

TYPEFLE=OUTPUT, * 

BLKSIZE=2 000, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

BUFNO=2, * 

RECSIZE=200, * 

SUFFIX=AA 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE2, * 

RECFORM=FIXBLK, * 

TYPEFLE=INPUT, * 

BLKSIZE=2000, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

BUFNO=2, * 

RECSIZE=200, * 

SUFFIX=BB 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE3, * 

RECFORM=FIXUNB, * 

BLKSIZE=1240, * 

TYPEFLE=INPOT, * 

DEVADDR= SYSO11, * 

DEVICE=TAPE, * 

SUFFIX=CC 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE4, * 

RECFORM=FIXUNB, * 

BLKSIZE=1240, * 

TYPEFLE=OUTPUT, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

SUFFIX=DD 

DFHDCT TYPE=FINAL 
| END 


DFHDCT TYPE=INITIAL, * 

SUFFIX=YY 

DFHDCT TYPE=SDSCI, * 

DSCNAME=PRINT, * 

RECFORM=VARUNB, * 

BLKSIZE=121, * 

DEVADDR=SYSLST, * 

DEVICE=1403 

DFHDCT TYPE=EXTRA, * 

DSCNAME=PRINT, * 

DESTID=PRNT 

DFHDCT TYPE=EXTRA, * 

RESIDNT= NO, * 

DESTID=TAPE 

DFHDCT TYPE=FINAL 
| END 


| Figure 3.2-3. DCT Using Nonresident Data Set Control Blocks and 
Nonresident Logic Modules 
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The result of the generation of the macro instructions contained in 
| Figure 3,2-3 is a destination control table with a suffix of YY 

(DFHDCTYY)• The DOT contains one data set control block for the printer 
(TYPE-SDSCI,DSCNAME=PRINT) and one logic module for the printer* The 
four data set control blocks for tape are also generated by the assembly 
| of the macro instructions contained in Figure 3*2-3* When the output of 
that assembly is link-edited* the data set control blocks are cataloged 
as DFHTRNAA, DFHTRNBB, DFHTRNCC, and DFHTRNDD. However* the user must 
have cataloged the logic modules used by these four data set control 
blocks to the DOS/VS private or system core image library, and must have 
included entries in the PPT that specify the REL0AD=YES operand for 
those logic modules* 

j When using the generated DOT of Figure 3*2-3, no storage is used for 
the data set control blocks or for the logic modules until the 
extrapartition destination (DESTID=TAPE) is opened using the CICS/VS 
dynamic open/close program (DFHOCP). The dynamic open/close program 
will ensure that only one logic module of the same name is in storage at 
any one time. If the logic module is not resident in the DCT, the 
dynamic open/close program frees the storage associated with the logic 
module when the data set is closed. 

For further details concerning the use of the dynamic open/close 
facility, see the discussion of dynamic open/close in DFHSG PROGRAM=OCP 
in Chapter 2.2, and in the Dynamic Open/Close Function (DFHOC) in 
Chapter 7.2 of this manual. 


FCT -- FILE CONTROL TABLE 

The file control table is used to describe to CICS/VS any user data sets 
(files) which are processed by file management. (Note that sequential 
data sets should be defined as extrapartition destinations using the 
DFHDCT macro.) The DFHFCT macro instruction is used to generate entries 
for the table and to request the following services: 

t DFHFCT TYPE=INITIAL - to set up the open list for the data sets to 
be used when initializing and terminating the system. 

! * DFHFCT TYPE=ALTERNATE - to define the ICIP characteristics of data 

| sets, which can be accessed by either normal VSAM or by VSAM ICIP. 

{ These are known as mixed mode files and can be used with the High 

| Performance Option (HPO) under 0S/VS2 Release 3.7 (MVS). 

• DFHFCT TYPE=DATASET - to describe characteristics of the data sets, 

such as access method used, record characteristics, types of 
service allowed. 

| • DFHFCT TYPE-INDACC - to define use of the data set as a cross index 
and provide the information to locate the next data set through 
indirect access. 

| • DFHFCT TYPE=LOGICMOD - to generate an ISAM superset module in-line 

| as part of the file control table (CICS/DOS/VS only). 

j • DFHFCT TYPE= REMOTE - to define files that are resident in a remote 
j system during an intersystem communication session. 

• DFHFCT TYPE=SEGDEF, TYPE=SEGHEAD, TYPE=SEGSET and TYPE=SEGLAST - to 
define the segments and segment sets of a record. 

• DFHFCT TYPE=FINAL - to terminate entries in the file control table. 
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The data control information for each data set is included in the 
DFHFCT macro instruction. The indirect access and segmenting services 
are mutually exclusive; the entry for one data set cannot specify both 
services. 


CONFIGURATOR 


This section is intended to aid the system programmer in the preparation 
of the file control table (FCT) when using the DFHFCT TYPE=DATASET macro 
instruction to describe the physical characteristics of the data sets. 
These descriptions include information about the access method (BDAM, 
DAM, ISAM, or VSAM) and record characteristics for the data sets. 
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2 Required if main storage high-level index processing is used. 

3 Required if INDAREA is specified. 

4 Required only if a master index exists. 

5 Optional; used only if SERVREQ=NEWREC; for ISAM data sets 
under CICS/OS/VS, IOWORK should also be specified. 

6 If SERVREQ-BROWSE or SERVREQ=NEWREC, this value must be 
BLKSIZE plus BLKKEYL. 

7 Required if key exists within logical records. 

8 Required if deblocking by key for BDAM (CICS/DOS/VS and 
CICS/OS/VS); required for variable-length ISAM records in 
fixed-length blocks (CICS/DOS/VS only). 

9 SERVREQ=KEY is required. 

10 Required if there is an associated DFHFCT TYPE=ALTERNATE macro. 

See the section on mixed mode files. 

11 BUFND should not be specified. The number of data buffers will be 
set to the value in STRNO- 

12 Required for TYPE=DATASET. Note that MODE= is not required for 
TYPE=ALTERNATE - see the section on mixed mode access, below. 

13 Required if ACCMETH=(VSAM,KSDS). 


CONTROL SECTION — DFHFCT TYPE=INITIAL 


The control section into which the file control table is assembled is 
established by means of the DFHFCT TYPE=INITIAL macro instruction, which 
must be coded as the first statement in the source deck used to assemble 
the file control table. 

r - r - r - 1 

j (DFHFCT j TYPE=INITIAL | 

| | j [,SUFFIX=xx) | 

L_L-L_J 


TYPE=INITIAL 

establishes the control section into which the file control 
table is assembled. 


SUFFIX=xx 

specifies a one- or two-character alphameric suffix (other than 
NO, which is reserved) for the file control table being 
assembled. This suffix, if specified, is appended to the 
standard module name (DFHFCT) and is used to name the module on 
the linkage editor output library. If this operand is omitted, 
a suffix is not provided. 


VSAM ICIP MIXED MODE ACCESS — DFHFCT TYPE=ALTERNATE 


| A mixed mode file is one that is defined so that it can be accessed 
| either as a VSAM file or as a VSAM ICIP file when the High Performance 
j Option (HPO) is used when CICS/OS/VS contains the SRBSVC operand in 
| DFHSG TYPE=INITIAL• 

To specify a mixed mode file, two consecutive DFHFCT macros must be 
generated. The first (TYPE=DATASET) defines the VSAM access 
characteristics, and the second (TYPE=ALTERNATE) defines the ICIP 
characteristics. 
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The TYPE=DATASET macro defines the VSAM characteristics of the file 
by using the VSAM (non-ICIP) parameters of the file control table. In 
addition, the MODE parameter must be specified thus: 

MODE={VSAM|ICIP|MIXED}, where VSAM is the default. MIXED indicates that 
this is the first DFHFCT macro of a mixed mode pair, and describes the 
VSAM characteristics. VSAM or ICIP describes the mode in which the file 
is to be opened and subsequently accessed, when CICS/VS is initialized. 
For example, if VSAM is specified, the file will be opened as a VSAM 
file with the characteristics defined in this file control table. If 
ICIP is specified, the file will be opened as an ICIP file with the 
characteristics defined in the TYPE=ALTERNATE macro which follows. 

The second mixed mode DFHFCT macro (which must immediately follow the 
first) has TYPE=ALTERNATE and defines the ICIP characteristics of the 
file, using the parameters described below. The DATASET name must be 
the same as that specified in the preceding DFHFCT macro. The MODE 
operand need not be specified in this macro. Users are advised to study 
the examples of ICIP and mixed mode files which are given at the end of 
the section on the file control table. 



TYPE=ALTERNATE 
,ACCMETH=VSAMC,KSDS|ESDS] 

,DATASET=name 

,SERVREQ=(request[,request],...) 

,STRNO=number 
[,BUFND=number] 

[,BUFNI=number] 

(,DATA=name] 

(,INDEX=(name(,number)]I( INIT IDYN}] 

[,JID=(NO I SYSTEM|nn>] 

(,JREQ=(ALL|(request (,request,...)]}] 

(,LOG=(NO|YES)] 

[,PASSWD=password] 

(,RECFORM=(((UNDEFINED)VARIABLE|FIXED}] 
,((BLOCKED|UNBLOCKED}])] 

(,STRNOG=number] 


TYPE=ALTERNATE 

indicates that the file control table defines the ICIP 
characteristics of a data set which can be accessed by either 
VSAM or by VSAM ICIP. 


| ACCMETH=VSAM(,KSDS|ESDS] 

specifies the type of VSAM data set to be accessed. The 
options are KSDS (key sequence data set) and ESDS (entry 
sequence data set). 


DATASET=name 

specifies the name of the data set to be used for processing by 
either normal VSAM or by VSAM ICIP. This name must be the same 
as that specified in a preceding DFHFCT TYPE=DATASET macro with 
MODE=MIXED specified. 


| SERVREQ-option 

defines the types of service request that can be processed 
against the data set. The parameters that can be included are 
as follows: 
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GET 


records on this data set may be read. 

PUT 

records may be written on this data set. 

UPDATE 

records may be updated on this data set. If UPDATE is 
specified, GET and PUT must also be specified. 

The STRNO, BUFND, BUFNI, DATA, INDEX, JID, JREQ, LOG, PASSWD, RECFORM, 
and STRNOG operands are as described in the DFHFCT TYPE=DATASET macro 
instruction, below. 


DATA SETS — DFHFCT TYPE=DATASET 


The physical characteristics of a data set are described to CICS/VS file 
management by the DFHFCT TYPE=DATASET macro instruction. This macro 
instruction includes operands that provide information about the access 
method, record characteristics, and the types of service allowed for the 
data set. This information is used to generate a DTF or ACB for 
CICS/DOS/VS or a DCB or ACB for CICS/0S/VS. 

If the DL/I facility of the IBM Information Management System/Virtual 
Storage (IMS/VS) is to be accessed under CICS/OS/VS or DL/I DOS/VS under 
CICS/DOS/VS, the DFHFCT TYPE=DATASET macro instruction is used to 
provide information about Data Language/I CDL/I) data bases. DATASET 
and ACCMETH are the only operands required for DL/I data bases although 
the OPEN operand may also be specified for CICS/DOS/VS. Physical 
characteristics of the DL/I data bases need not be specified because 
they are specified during generation of IMS or DL/I DOS/VS Data Base 
Descriptions (DBDs). A DFHFCT TYPE=DATASET entry must be provided for 
each DL/I data base (that is, for each DBD) 

The file control table entry defining a VSAM data set will require a 
minimum of specific information. Such values as logical record length, 
and relative key position will be obtained by system initialization 
after the data set is opened and placed in the CICS/VS portion of the 
file control table. 

The DFHFCT TYPE=DATASET macro instruction can include the operands 
shown below. Note that the optional operands are presented in the 
following manner in the syntax display: 

• Operands that apply to all access methods 

• Operands that apply to all access methods except VSAM 

• ISAM-only operands 

• DAM-only operands 

• VSAM-only operands 

to allow the user to see which operands are applicable to the system on 
an access method basis. The descriptions of these optional operands are 
arranged alphabetically following the description of the required 
operands. 
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DFHFCT 


TYPE=DATASET 
,DATASET=name 

,ACCMETH= {BDAM|ISAM|DL/I|VSAM[, KSDS IESDS|RRDS]} 
,SERVREQ=(requestl,request],...) 
t,FILSTAT=(( ENABLED I DISABLED],( OPENED I CLOSED})1 
(,JID=(NO|SYSTEM | nn>] 

(,JREQ=(ALL|(request (,request,...])}] 
[,LOG=(NO|YES]] 

(,OPEN=(INITIAL|DEFERRED)] 

(,RECFORM=(((UNDEFINED|VARIABLE|FIXED]] 

({,BLOCKED|UNBLOCKED]](,DCB format])] 

Non-VSAM 

(,BLKKEYL=length] 

(,BLKSIZE=(length(.length])] 

(,KEYLEN=length] 
t,LRECL=(length(,length])] 

(,RKP=number] 

(,VERIFY=YES] 

ISAM only 

(, INDAREA= symbolie-name] 

(,INDSIZE=length] 

[,IOSIZE=length] 

DAM only 

(,RELTYPE=(HEX|DEC| BLK]] 

(,SRCHM=(YES|number]] 

VSAM only 

[,BUFND=number] 

(,BUFNI=number] 

(,BUFSP=number] 

[,PASSWD=password] 

(,STRNO=number] 

For DOS/VS Only 

(,CYLOFL=number1 

(,DEVICE=(2314,2314)|n((,m])] 

(,EXTENT=number] 

(,INDSKIP=YES] 

[,MSTIND=YES] 

(,NRECDS=number] 

For OS/VS Only 

(,BASE=name] 

(,DATA=name] 

(,INDEX=(name(,number)]|(,INIT|DYN)] 

(,IOWORK=symbolic-nameJ 
(,MODE=(VSAM|ICIP][.MIXED]] 

(,STRNOG=number] 


TYPE=DATASET 

specifies the data sets in the system- 
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DATAS ET=n ame 

specifies the symbolic data set name to be used as the file 
control table entry for a specific data set. This data set 
name can consist of from one to seven characters in CICS/DOS/VS 
and from one to eight characters in CICS/OS/VS. Because this 
data set name is used when generating the operating system 
control block (DCB, DTF and ACB), it must be the same as the 
DOS/VS file name or the OS/VS DDNAME used in the job control 
statement defining the data set, except for VSAM ICIP KSDS 
files where the DDNAME of the cluster need not be specified. 

If VSAM alternate index support is used to access a base 
cluster via an alternate index path, the data set name must be 
the same as the name of the alternate index path. This is 
specified on the DOS/VS file name or on the OS/VS DDNAME used 
in the job control statement defining the path. No entry is 
required in the file control table for the alternate index that 
is used to access the base data set. The link between the 
alternate index and the base data set is established when the 
path is defined using Access Method Services. 

Further information on the definition of alternate indexes and 
paths can be found in the relevant DOS/VS and OS/VS Access 
Method Services manuals. 

Note : The data set name should not start with characters "DFH" 

because this becomes an externally specified name, and CICS/VS 
reserves the right to use any character string beginning with 
"DFH" • Therefore use of "DFH 1 * may cause compatibility problems 
for the user. In addition, using "FCT" for a data set name 
prefix can cause assembly errors. 

For a DL/I data base, the DATASET operand must specify the same 
data base name as that specified in the NAME operand when 
generating the DBD. 


ACCME TH=method 

specifies the method of organization for a specific data set. 
BDAM 

Basic Direct Access Method. 

ISAM 

Indexed Sequential Access Method. 

VSAM 

Virtual Storage Access Method. 

KSDS 

key sequence data set. KSDS is the default when 
ACCMETH=VSAM. 

ESDS 

entry sequence data set. 

RRDS 

relative record data set. 


DL/I 

Data Language/I. A DFHFCT TYPE—SHRCTL macro must be 
specified for DL/I data bases generated with SERVREQ=SHARE. 

Note : Any data set accessed by calls to DL/I ENTRY DOS/VS 

should have ACCMETH=VSAM, and not ACCMETH=DL/I. 
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| SERVREQ=option 

defines the types of service request that can be processed 
against the data set* The parameters that can be included are 
as follows: 

GET 

records on this data set may be read. 

PUT 

records may be written on this data set. 

UPDATE 

records may be updated on this data set. If UPDATE is 
specified, both GET and PUT are implied and need not be 
specified. 

NEWREC 

records may be added to the data set. NEWREC implies that 
PUT was also specified. NEWREC must be specified for OS/VS 
ISAM data sets with variable-length records if updating 
with a change in length is to be performed. 

INDACC 

data set is used as a cross index. If INDACC is specified, 
the DFHFCT T YPE=INDACC macro instruction must be generated 
immediately following this DATASET definition. 

SEGMENT 

records are segmented. If SEGMENT is specified, the DFHFCT 
TYPE=SEGHEAD, DFHFCT TYPE=SEGDEF, DFHFCT TYPE=SEGSET, and 
DFHFCT TYPE= SEGLAST macro instructions must be generated 
immediately following this DATASET definition. 

Note : INDACC and SEGMENT cannot both be coded for the same 

data set. A data set used as a cross-index data set may not be 
defined as blocked BDAM. 

BROWSE 

records may be sequentially retrieved from the data set. 
BROWSE implies that GET was also specified. For 
CICS/DOS/VS, DFHFCT TYPE=LOGICMOD must be specified in 
order to use BROWSE for an ISAM file. 


I 

I 

I 


KEY 

records are to be retrieved by key from a DAM data set. 

This parameter can be specified only if ACCMETH=BDAM. 

NOEXCTL 

records are not to be placed under exclusive control when a 
read for update is requested. Unless this parameter is 
specified, a read-for-update will cause the record to be 
placed under exclusive control (within the CICS/VS 
partition/region). NOEXCTL may not be specified if 
ACCMETH=VSAM or LOG=YES are specified. Users of OS/VS with 
BDAM may specify LOG=YES and SERVREQ=NOEXCTL. 

DELETE 

records may be deleted from this data set. DELETE implies 
that UPDATE was specified. This is applicable to VSAM KSDS 
(key sequence) data sets only. 
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SHARE 

indicates that this data set is to share resources. This 
parameter may only be specified when ACCMETH=VSAM. This 
service cannot be requested for a path, or for the base 
data set of an alternate indexing structure in which there 
is an upgrade set. If this option is specified, a DFHFCT 
TYPE= SHRCTL will be generated. The system programmer may 
either use this CICS/VS-provided macro, or may generate one 
explicitly. 

REUSE 

indicates that this data set is reuseable. 

Recovery/restart support is not available for reuseable 
data sets. This option is only applicable when 
ACCMETH=VSAM is specified. 

Notes : 

1. If any output service request option is to be added 
dynamically through the CSMT program facility, at least one 
output option (for example, SERVREQ=PUT) must be specified 
at assembly time. Similarly, for input options to be added 
with CSMT, at least one input option must have been 
specified in SERVREQ at assembly time. 

2. Only GET, PUT, and UPDATE are valid for VSAM ICIP data 
sets. 

3. To support the dynamic transaction backout facility, the 
reverse function for each operation specified in the 
SERVREQ operand must be generated. For example, 

SERVREQ=DELETE must be specified as well as SERVREQ=NEWREC. 


I 


I 


BLKKEYL=length 

specifies a decimal value from 1 through 255 which represents 
the physical key length for a direct access record. This 
operand must be specified for ISAM data sets and DAM data sets 
with physical keys. If a DAM data set contains blocked 
records, and deblocking is to be performed by using a logical 
key (that is, a key embedded within each logical record), the 
logical key length is specified by using the KEYLEN operand. 

The physical key may not exceed 225 bytes. 

If necessary, CICS/VS may place a record under exclusive 
control by building an ENQ argument by concatenating the data 
set name, the block reference (if DAM), and the physical key. 

An ENQ will then be issued using a maximum of 255 bytes of this 
argument. If the argument exceeds 255 bytes in length, the ENQ 
will result in placing a range of keys under exclusive control. 
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BLKSIZE=length 

specifies the length (in bytes) of the block. If blocks are 
variable-length or undefined, for CICS/OS/VS, the length 
specified should be the maximum block length. For undefined 
blocks, with CICS/DOS/VS, the length should be the maximum 
user-defined blocksize plus 8. If the NEWREC or BROWSE 
operands are used for DAM fixed-length data sets with keys, 
BLKSIZE must be (LRECL + BLKKEYL) for unblocked records or 
(LRECL * BLOCKING FACTOR + BLKKEYL) for blocked records. This 
operand is not required for VSAM. 

For CICS/DOS/VS, this operand should contain only one value 
(parameter)• This value should not be enclosed within 
parentheses. 

If the CICS/OS/VS user wishes to have a BLKSIZE value generated 
in the DCB, he must specify that value in the second parameter 
of the operand; for example, BLKSIZE=(250,250), where the first 
"250" relates to the FCT and the second "250” relates to the 
DCB. If the second parameter is not specified, the DCB is 
generated without a BLKSIZE value. The DCB value (second 
parameter) should always specify the true block size while the 
FCT value (first parameter) may, for DAM data sets, include the 
BLKKEYL value. In no case should the first BLKSIZE value 
specified be less than the actual blocksize of the data set. 


BUFND=number 

specifies, for VSAM only, the number of buffers to be used for 
data. The minimum specification is the number of strings plus 
one (see the STRNO operand). 

For VSAM ICIP files, BUFND should be omitted (when the value of 
STRNO will be used) or made equal to STRNO. (If BUFND is less 
than STRNO, it will be set to the value in STRNO. If BUFND is 
greater than STRNO, extra fixed buffers and RPLs will be 
obtained and not used.) 


BUFNI=number 

specifies, for VSAM only, the number of buffers to be used for 
the index. For non-ICIP files, the minimum specification is 
the number of strings specified in the STRNO operand. 

BUFNI is required for VSAM KSDS files when MODE=ICIP is 
specified. The number specified for BUFNI need bear no special 
relation to the number of strings indicated in STRNO, but must 
be at least one. BUFNI specifies the number of index buffers 
and index RPLs which are obtained when the file is opened. 


Notes : 

1. If BUFSP exceeds the requirements of BUFND and BUFNI, the number of 
buffers will be increased proportionally. 

2. All I/O buffers are acquired by OPEN for VSAM, and are controlled 
exclusively by VSAM during execution. CICS/VS file management 
causes VSAM to move all data into a file work area. Under some 
circumstances, CICS/VS will use LOCATE mode and move the data 
itself into the appropriate area. If the user request is for 
LOCATE mode, the address of the data in the VSAM buffer will be 
returned in a VSAM work area. 
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BUFSP=number 

specifies, for VSAM only, the size in bytes of the area to be 
reserved for buffers for this data set within the CICS/VS 
region/partition. If less than the minimum is specified, VSAM 
will not open the data set. If this operand is not specified, 
VSAM OPEN will obtain a minimum size area, which will be the 
minimum storage required to process the data set with its 
specified processing options. 

In DOS/VS, if the BUFSP value specified is greater than the 
minimum value required but less than the values required for 
BUFND and BUFNI, the size of the buffeL space allocated will be 
changed to conform with the requirements of BUFND and BUFNI. 

In OS/VS, the number of buffers will be proportionally reduced 
to comply with the requirements of BUFSP. 

For further details on defining VSAM buffer space, refer to the 
appropriate Access Method Services manual. 

Note : Extreme care should be taken in choosing the value 

specified in the BUFSP operand. While the file is open, this 
storage space is controlled exclusively by VSAM; it will be 
used only for buffers and only for the specified file unless 
the VSAM shared resources facility is used (see "VSAM Shared 
Resources Control" later in this section). Even with quite low 
activity on the file, this buffer space could remain in main 
storage for a significant percentage of the time that the file 
is open. Thus it could have a considerable impact on the 
working set. This operand is not required for VSAM ICIP files 
and will be ignored if specified. 


| FILSTAT=status 

specifies the initial status of the data set. The status may 
be changed by using the master terminal function. The default 
is FILSTAT=(ENABLED,OPENED). 

ENABLED 

indicates that normal processing is to be allowed against 
this data set. 

DISABLED 

indicates that any request against this data set will cause 
the application program to be abnormally terminated. 

OPENED 

indicates that the data set is to be opened by system 
initialization. 

CLOSED 

indicates that the data set is to remain closed until a 
request is made to open it either through the master 
terminal function, or through a DFHOC macro instruction in 
an application program. 


INDAREA=symbolic-name 

specifies the unique symbolic name which is used by the DFHFCT 
macro to generate a storage area automatically (within the file 
control table) which will contain all or part of the cylinder 
index. This operand is only required if ACCMETH=ISAM and the 
cylinder index is to be processed in dynamic storage. 
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INDSIZE=length 

specifies the length (in bytes) of the cylinder index area 
specified in the INDAREA operand. 

For CICS/DOS/VS, the minimum number of bytes can be calculated 
as: 


(m+3)*(keylength+6) 

where "m" is the number of entries to be read into main storage 
at one time, 3 is the number of dummy entries, and 6 is an 
abbreviated pointer to the cylinder. If m is set to the number 
of prime data cylinders + 1, all of the cylinder index is read 
into main storage at one time. 

For CICS/OS/VS, the minimum number of bytes can be calculated 
as: 


(number of tracks in high-level index)* 

(number of entries per track)* (keylength+10) 

This operand is applicable only if ACCMETH=ISAM and the INDAREA 
operand is specified. 


IOSIZE=length 

specifies the number of bytes in the main storage area used 
when adding records to an ISAM data set. This operand should 
only be used when ACCMETH=ISAM and SERVREQ=NEWREC are also 
specified. In CICS/DOS/VS, this operand causes a static work 
area to be generated as part of the FCT entry for the data set 
being defined. In CICS/OS/VS, the IOWORK operand must also be 
used to supply a symbolic name to be associated with the work 
area. For further details, refer to DTFIS generation in DOS/VS 
Supervisor and I/O Macros , or ISAM data set processing in OS/VS 
Data Management Macro Instructions . 

| Note : Under CICS/DOS/VS with multiple ISAM files, if the 

I IOSIZE operand is specified for any one ISAM file with the 

| SERVREQ=NEWREC option, in order to avoid the need for two ISAM 

j logic modules (one with and one without the CORDATA=YES 

I option), all other ISAM files must have SERVREQ=NEWREC and an 

| adequate IOSIZE specified. 


| JID=NOI SYSTEMjnn 

specifies whether automatic journal activity is to take place 
| for this FCT entry and identifies the file to be used to record 

j the journaled data. The operations which will cause data 

records to be journaled are specified in the JREQ parameters. 
The default is JID=NO. 


NO 

indicates that journal activity will not occur on this FCT 
entry. 

SYSTEM 

indicates that journaling is to be performed on the system 
log. 
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nn 

is the journal identification and can contain a value in 

the range 2 through 99. 

Note ; Automatic journaling may be specified if the user wishes 
to record data set activity for subsequent processing by the 
user (for example, user-written data set I/O recovery). It 
should not be confused with automatic logging, (specified with 
LOG=YES) which is required if CICS/VS is to perform data set 
backout to remove in-flight task activity during emergency 
restart or dynamic transaction backout. 


| JREQ=reque st 

specifies which data base operations will be automatically 
journaled and whether the journaling operation is to be 
synchronous or asynchronous with data set activity. When a 
synchronous journal operation is executed for a READ request, 

| control is not returned to the program which issued the file 

j control request until the data read is written on the journal 

data set. When a synchronous journal operation is executed for 
a WRITE request, the output operation to the data set is not 
| initiated until the data is written on the journal data set. 

When an asynchronous journal operation is executed for a READ 
request, control may be returned as soon as the data read is 
moved to the journal I/O buffer. When an asynchronous journal 
operation is executed for a WRITE request, the output operation 
to the data set may be initiated as soon as the data is moved 
to the journal I/O buffer. Synchronization defaults provide 
asynchronous operation for reads and synchronous operation for 
writes. If this operand is omitted and JID is specified, JREQ 
will default to JREQ=(WU,WN). 


ALL 

Journal all data set activity with READ asynchronous and 
WRITE synchronous. 

RO 

Journal READ ONLY operations 
RU 

Journal READ UPDATE operations 
WN 

Journal WRITE NEW operations 

wu 

Journal WRITE UPDATE operations 

SYN 

Synchronous journal operation for READS 

ASY 

Asynchronous journal operation for WRITES 


I 

I 

I 

I 


KEYLEN=length 

specifies the length of the logical key for the deblocking of 
DAM data sets. This operand is also applicable for remote 
files. If omitted for this type of file, the length option 
must be specified in the application program that refers to 
this file. 
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The logical key for DAM data sets is embedded and located 
through the use of the RKP operand. The length of the recorded 
(physical) key is specified in the BLKKEYL operand, and may be 
different from the value specified for KEYLEN. 

This operand must always be specified when logical keys are 
used in blocked DAM data sets, and must not be specified for 
VSAM data sets. 


| L0G=N0|YES 

specifies whether automatic logging to the system log is to be 
performed. The logging function, as opposed to automatic 
journaling, records all data necessary to backout data base 
updates, additions, and deletions in case of an emergency 
restart or dynamic transaction backout. The data recorded is 
the "before" copy of the record for update-in-place operations, 
unique record ID for additions, and a copy of the record for 
deletions. The default is LOG=NO. 

NO 

indicates that automatic logging is not to be performed- 

YES 

indicates that automatic logging is to be performed. 

Note ; If LOG=YES is specified, when a request is made to 
alter the contents of this data set, the record being 
updated, added, or deleted will be enqueued upon using the 
record identification. This enqueue will be maintained 
until the task terminates or issues a DFHSP macro to signal 
the end of a logical unit of work. This is necessary to 
ensure the integrity of the altered data. Because the 
enqueues are thus maintained for a longer period of time, 
the potential for an enqueue lockout exists if an 
application program that accesses this data set performs 
what is effectively more than one logical unit of work 
against it without defining each separate logical unit of 
| work to CICS/VS .by issuing the sync point request. 

Also, long running tasks could tie up storage resources. 

If an alternate index structure is being used and recovery 
is required, all updates to the base data set must either 
be made via the base data set or via a single path. It is 
strongly recommended that all updates are made directly on 
the base data set and that paths are used for enquiry only. 

| If an attempt is made to perform a generic delete when 

j LOG=YES is specified, an invalid request will result. 


LRECL=length 

specifies the maximum length (in bytes) of the logical record. 

| The value specified is also the length of records in a fixed 

j length remote file. If this operand is not specified, the 

j length may be specified in the application program. Refer to 

| the DFHFCT TYPE=REMOTE macro for further information on remote 

j files. For DOS/VS ISAM data sets with variable-length records 

within fixed-length blocks, this number has no relation to the 
actual length of any logical record. However, the number 
specified, multiplied by the NRECDS parameter, must equal the 
actual block size on the data set. This operand must always be 
specified for ISAM and DAM data sets, but is not required for 
VSAM data sets. 


Chapter 3.2. DFHFCT TYPE=DATASET 


129 



For CICS/DOS/VS, this operand should contain only one value 
(parameter). This value should not be enclosed within 
parentheses. 

If the CICS/OS/VS user wishes to have an LRECL value generated 
in the DCB, that value must be specified in the second 
parameter of the operand; for example, LRECL=(50,50), where the 
first "50" pertains to the FCT and the second "50" pertains to 
the DCB. If the second parameter is not specified, the DCB is 
generated without a LRECL value. If the data set is BDAM 
organized, the second parameter should never be specified. 


| OPEN=INITIAL|DEFERRED 

specifies the initial status of the data set and may only be 
specified if FILSTAT is not specified. The default is 
OPEN=INITIAL. 

INITIAL 

causes the data set to be opened by system initialization. 
DEFERRED 

causes the data set to remain closed until the user 
indicates that he wishes to open it by using the master 
terminal open/close service function or by a DFHOC macro 
instruction in an application program. 

Note : If the user specifies OPEN=DEFERRED for DL/I DOS/VS 

data bases, the data set will not be opened until the user 
indicates that he wishes it opened using the appropriate 
services of the DL/I DOS/VS interface. 


PASSWD=pa s sword 

specifies a one- to eight-character password which VSAM will 
use to verify the user access to the data set. If less than 
eight characters are specified, the password will be padded to 
the right with blanks to fill out the eight characters. If 
omitted, and the data set is password protected, the console 
operator may be asked to provide the appropriate password. 

This operand is only applicable if ACCMETH-VSAM. 


| RECFORM=record-format 

describes the format of records on the data set. The default 
is UNDEFINED for ISAM and BDAM data sets and (VARIABLE,BLOCKED) 
for VSAM data sets. 

FIXED 

records are fixed length. 

VARIABLE 

records are variable length. 

UNDEFINED 

records are of undefined length. 

BLOCKED 

records are blocked. 

UNBLOCKED 

records are not blocked. 
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DCB format 

specifies the record format in the DCB; for example, 
RECFORM=(FIXED,BLOCKED,FBS). 

Notes : 

1. For CICS/OS/VS ISAM data sets with the BROWSE option 
specified, a DCB RECFM parameter of VB or FB is always 
generated, regardless of whether or not the data set is 
blocked, 

2. BLKSIZE must include an additional eight bytes for the 
count field when NEWREC is specified for undefined records 
in CICS/DOS/VS. 

3. BLOCKED or UNBLOCKED must be specified for all ISAM and 
BDAM data sets of FIXED or VARIABLE format. 

4. ISAM compatibility is indicated by specifying the UNBLOCKED 
characteristic for a VSAM data set. This means that the 
record will be returned in a FIOA for all non-segmented, 
read-only requests. 

5. The DCB format is not applicable to VSAM data sets. 


| RELTYPE=HEX|DEC|BLK 


specifies that relative addressing is being used in the block 
reference portion of the record identification field of DAM 
data sets only. If the RELTYPE operand is omitted, absolute 
addressing is assumed (that is, MBBCCHHR). The EXTENT= 
parameter must also be specified if RELTYPE= is used in 
CICS/DOS/VS. 


HEX 


indicates that the hexadecimal relative track and record 
format is being used. 


DEC 


indicates that the zoned decimal format is being used. 


BLK 


indicates that relative block addressing is being used. 
BLK applies to CICS/OS/VS only. 


RKP=number 

specifies the starting position of the key field in the record 
relative to the beginning of the record (position zero for DAM 
and ISAM data sets except position one for DOS/VS ISAM data 
sets). With variable-length records, this operand must include 
the four-byte LLbb field at the beginning of each logical 
record. This operand must always be specified for data sets 
which have keys within each logical record, or when browsing. 

Notes : 

1. SERVREQ=BROWSE requires embedded keys in the data field in 
DOS/VS ISAM, therefore the RKP parameter is required. 

2. In DOS/VS ISAM, if records are unblocked, the following 

MNOTE will be generated by ISAM in the DTFIS: "0, KEYLOC 

INVALID, PARAMETER IGNORED”. 
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| SRCHM=YES|number 

provides a multiple track search for keyed records. This 
| operand is applicable only to DAM keyed data sets. 

YES 

indicates that multiple track search will be used. 
SRCHM=YES must be specified if fixed-length records with 
keys are to be added to the file. This option applies to 
CICS/DOS/VS only, 

number 

indicates the number of tracks or blocks to be searched. 
The default is 0. This option applies to CICS/OS/VS only. 

For further details, see the SRCHM operand under DTFDA 
generation in DOS/VS Supervisor and I/O Macros , or BDAM data 
set processing in OS/VS Data Management Macro Instructions . 


STRNO=number 

specifies the number of concurrent requests which can be 
processed against the data set. When the number of requests 
reaches this limit, CICS/VS will automatically queue any 
additional requests until one of the active requests 
| terminates, unless VSAM shared resources are being used. In 

j this case, control is given to the user "illogic" error routine 

j because a VSAM error that does not fall into one of the other 

| CICS/VS response categories has been detected. CICS/VS will 

accumulate statistics which will aid the system programmer in 
determining the optimum STRNO value for this particular 
configuration. This operand is applicable only if 
ACCMETH=VSAM, in which case it is required. The user must 
specify a value for STRNO because there is no default value 
available, except for ICIP files where the value specified in 
BUFND is used if available or a default value of 1 is assumed. 

Note s For ICIP files, STRNO specifies the number of data 
buffers and data RPLs obtained when the data set is opened. 


VERIFY=YES 

indicates that the user wants to check the parity of disk 
records after they are written. If this operand is omitted, 
records are not verified after a write request. This operand 
is not valid when ACCMETH=VSAM is specified. 


For DOS/VS only 


CYLOFL=number 

specifies the number of tracks per cylinder which are reserved 
for cylinder overflow records. Note that CYLOFL=0 is an 
invalid specification. If no cylinder overflow space is to be 
reserved the operand should be omitted completely. This 
operand is only required if ACCMETH=ISAM. 


| DEVICE=device 

specifies the type of device to be used for DAM and ISAM data 
| sets. The applicable devices are 2314, 3330, 3340, and 3350 

| (DAM only). The default is DEVICE=(2314,23143. 
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n 

for DAM, specifies the device type on which the data set 
resides. 

for ISAM, specifies the device type on which the prime data 
area (and overflow area if present) resides. 

m 

for ISAM only, specifies the device type containing the 
high-level index. 


EXTENT=number 

represents the maximum number of extents that are specified for 
a data set. This operand is required if ACCMETH=ISAM. 

EXTENT=2 represents a minimum value (one for prime data area 
and one for cylinder index). If ACCMETH=BDAM, the presence of 
the EXTENT operand indicates that relative addressing (as 
opposed to actual addressing) is being used and the RELTYPE 
operand must also be used. 


INDSKIP=YES 

indicates that the index skip feature is to be used if index 
entries reside in main storage. This operand is only 
applicable if ACCMETH=ISAM and the INDAREA operand are 
specified. 


MSTIND=YES 

indicates that a master index exists for the ISAM data set. 
This operand is only applicable if ACCMETH=ISAM and should be 
specified only if a master index exists for the data set. 


NRECDS=number 

specifies, for CICS/DOS/VS only, the number of logical records 
in a block, and is called the blocking factor. This operand is 
only applicable if ACCMETH=ISAM, and if the records are 
blocked. For DOS/VS ISAM data sets with variable-length 
records within fixed-length blocks, this number has no relation 
to the actual number of records within the block. However, the 
number specified multiplied by the LRECL parameter must equal 
the actual block size on the data set. 

Note : NRECDS=1, LRECL=blocksize, is not allowed. The most 

advantageous specification is NRECDS=n, LRECL 5 =(blocksize/n) 
where n is some decimal value greater than 1. 
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For OS/VS only 


BASE=name 

specifies, for OS/VS only, the name of the base data set of an 
AIX (alternate index) structure. This parameter should only be 
specified for an AIX path, and only if the path and its base 
are to participate in VSAM data set sharing under CICS/OS/VS. 
The file control table must contain an entry for the base data 
set if this operand is specified. 

Data set sharing gives improved data set integrity. The user 
should note, however, that when data set sharing is used for an 
AIX structure, all the control blocks for access to the base 
are created when the first member of the structure is opened, 
whether this is a base data set or a path. Thus, as soon as 
any member of the structure is opened, the number of VSAM 
strings allocated to the base is equal to the sum of the number 
of the CICS/VS strings (indicated in the STRNO operand) 
specified on the FCT entries. This applies for the base data 
set and for all the paths defined over it that have BASE=name 
specified. 


DATA=name 

is required when a VSAM KSDS cluster is to be accessed using 
VSAM ICIP. Name is the ddname of a DD statement which defines 
the data component of the cluster. This operand must be 
specified when KSDS files are accessed using ICIP. Refer to 
the examples of mixed mode files at the end of the file control 
section. 


| INDEX=option 

must be specified if the data set is a VSAM ICIP KSDS cluster 
and is to be accessed using ICIP by means of keys. See the 
examples of mixed mode files given below. 

name 

is the ddname of a DD statement which specifies the index 
component of the cluster. 

number 

indicates the number of levels of VSAM index to be excluded 
when building an in-memory index. The default is one. 


INIT 

indicates that all levels of index that are to be retained 
in memory will be read into memory when the file is opened. 
This is the default if neither INIT nor DYN is specified. 


DYN 

indicates that the in-memory index will be created 
dynamically; that is, an index record required in memory 
will only be put in memory when it is referenced in 
response to a GET request for that file. 
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IOWORK=s ymbolie*name 

specifies the symbolic name of a main storage work area to be 
used by the access method when adding records to ISAM data 
sets. If the data set contains variable-length records, this 
operand must be specified. This operand is only applicable if 
ACCMETH=1SAM• 

It is permissible for the same symbolic name to be specified in 
more than one data set definition, thus causing an area to be 
shared. CICS/VS prevents the shared area from being used 
concurrently by more than one transaction. 

A static work area is generated within the FCT for each unique 
symbolic name encountered during FCT generation. The size of 
each area is equal to the largest IOSIZE specified for each 
symbolic name. 


| MODE- VSAM |ICIP|MIXED 

indicates whether the data set may be accessed by normal VSAM 
processing, by VSAM improved control interval processing 
(ICIP) f or by either method. This operand is only available 
when ACCMETH=VSAM is specified. The default is VSAM. 

The VSAM improved control interval processing feature (ICIP), 

| which is only available in CICS/OS/VS when the SRBSVC operand 

| is specified in DFHSG TYPE=INITIAL, provides a fast path, 

resulting in improved performance for accessing control 
intervals for both KSDS and ESDS files. 

VSAM 

indicates that the data set is to be opened for normal VSAM 
processing. 


ICIP 

indicates that the data set is to be opened for VSAM ICIP 
processing. The data format for ICIP files is identical to 
that of normal VSAM ESDS and KSDS data sets, and the data 
set may subsequently be processed using normal VSAM. When 
MODE=ICIP is specified, only the GET, PUT and UPDATE 
options of the SERVREQ operand may be specified. 

MIXED 

indicates that the data set may be accessed by either 
normal VSAM or by VSAM ICIP, using the same data set name. 
The DFHOC macro (with the MODE option specified) may be 
used to close and reopen the file. Refer to Chapter 7.2 
for further details on DFHOC. If MODE=MIXED is specified, 
a DFHFCT TYPE=ALTERNATE macro instruction must be 
specified. Users should study the examples on ICIP and 
mixed mode files which are given at the end of the file 
control section. 

The following considerations apply to data sets accessed by 
VSAM ICIP: 


• The control interval size must equal the physical record 
size. 

• New records may not be added to a file while it is being 
accessed using VSAM ICIP. 

• Browsing and segmenting are not supported. 
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• Sharing of resources is not supported. 

• Indirect access and alternate indices are not supported. 

• Relative record files are not supported. 

• Spanned records are not supported. 

• Buffers for use with VSAM ICIP will be in fixed pages to 
avoid the overhead of VSAM fixing pages for each access. 

• Data sets which have either replicated index records or 
sequence set records adjacent to control areas are not 
supported. 


STRNOG=number 

indicates the number of strings to be reserved for GET only 
processing for VSAM files. STRNOG specifies a decimal integer 
which is less than the STRNO value specified, and greater than 
or equal to 0. The default value is 20% of the STRNO value 
specified. 


| CROSS-INDEX DATA SET RECORD — DFHFCT TYPE=INDACC 


The record on a cross-index data set that points to the next data set to 
be read is described using the DFHFCT TYPE=INDACC macro instruction. 

This macro instruction may also contain information regarding duplicate 
records which may be referenced by this index record, including a 
pointer to a duplicate data set which contains additional identifying 
information. If this macro instruction is used, the SERVREQ operand of 
the DFHFCT TYPE=DATASET macro instruction must include GET and INDACC. 
For further information on indirect accessing, refer to the section on 
File Control in the CICS/VS Application Programmer's Reference Manual 
(Macro Level). 



TYPE=INDACC 
,IALKFL=length 
,IARLKP=number 
,OBJDSID=name 
t,ARGTYP=(KEY|RBA>] 

C,DUPDSID=name] 

( ,IADADMI = {RELREC|KEY}] 

C,IADIII=character] 

[,SRCHTYP= f FKEQ |FKGE|GKEQ|GKGE}] 


TYPE=INDACC 

specifies an indirect access data set. 


IALKFL=number 

specifies the length (in bytes) of the record identification 
field that is to be used to access the object data set. This 
operand must always be specified. 
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IARLKP=number 

specifies the relative location within the cross-index data set 
record of the record identification field which is to be used 
to access the object data set. The displacement is relative to 
the beginning of the record (position zero). This operand must 
always be specified. 


OBJDSID=name 

| specifies the name of the object data set referenced by the 

cross-index data set record. This name can consist of from one 
to seven characters in CICS/DOS/VS and from one to eight 
characters in CICS/OS/VS. This operand must always be 
specified. 


| ARGTYP=KEY|RBA 

specifies information concerning the argument contained in the 
cross-index record. The default is ARGTYP=KEY. 


KEY 

indicates that the argument is a key. 

RBA 

indicates that the argument is a relative byte address. 

The ARGTYP operand is applicable only when the object data set 
indicated by OBJDSID is a VSAM data set. 


DUPDSID=name 

specifies the identification for the duplicate data set 
associated with the cross-index data set. This identification 
can contain up to seven characters for CICS/DOS/VS and up to 
eight characters for CICS/OS/VS. This operand may be omitted 
if a duplicate data set does not exist. 


| IADADMI=RELREC|KEY 

specifies the argument type for the deblocking of a record from 
a blocked BDAM data set. 

RELREC 

indicates that the deblocking technique is relative record. 


KEY 

indicates that the deblocking technique is key. 

This operand can only be used if the data set (file) to which 
this index data set points is the primary (target) data set. 
If this operand is omitted, and if the data set to which this 
index data set points is a blocked BDAM data set, the entire 
block is returned to the user in the file control area. 


IADIII=character 

specifies a one-byte user-assigned hexadecimal character which 
signifies that the data in the record identification field 
refers to a duplicate data set rather than the normal object 
data set. This code must be contained in the first position of 
the record identification field and must be different from any 
other data that would normally appear in this position. This 
operand must always be specified if a duplicate data set name 
is specified (DUPDSID). 
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| SRCHTYP ^FKEQ 1FKGEIGKEQ1GKGE 

describes the key and how it is to be used when retrieving the 
record from the object data set. This operand is only 
applicable when the object data set indicated by OBJDSID is a 
VSAM data set and when ARGTYP=KEY. The default is 
SRCHTYP=FKEQ. 


FKEQ 

specifies that the key contained at the RDIDADR address is 
a full key and that a record with this exact key will 
satisfy the search. 


FKGE 

specifies that the search argument is a full key and that 
the first data record with a key equal to or greater than 
the argument will satisfy the search. 


GKEQ 

specifies that the search argument is a generic (partial,) 
key, the length of which is specified in the first byte of 
the record identification field. The search is satisfied 
if a record is found, the key of which is equal to the 
argument (compared only on the number of bytes specified). 


GKGE 

specifies that the search argument is a generic key and 
that the first data record with a key equal to or greater 
than the generic argument will satisfy the search. 


SUPERSET ISAM LOGIC MODULE -- DFHFCT TYPE=LOGICMOD 


A superset ISAM logic module may be generated in-line within the file 
control table by including a DFHFCT TYPE=LOGICMOD macro as the last 
statement in the file control table. 

Any further ISAM logic modules required in order to resolve V-cons in 
the file control table are indicated by MNOTEs that are produced when 
DFHFCT is assembled. One file control table may need up to four 
DFHISMODs, depending on whether or not support for rotational position 
sensing (RPS) and the "prime data in main storage" option of ISAM record 
addition (the CORDATA= YES option) is required, giving a total of four 
combinations of functional support. In general, these additional 
modules must be assembled separately and link-edited into the file 
control table. 

In many cases, the user may only need one ISAM logic module; however, 
DFHFCT always makes provision for both RPS and non-RPS versions. If RPS 
is not used, the V-con(s) for the RPS module(s) can be left unresolved 
at the link-edit stage. Where RPS is used exclusively, the V-con(s) for 
the non-RPS module(s) may be left unresolved, but only at the risk of 
errors if the conditions at execution are unsuitable for the use of RPS. 

The requirement for ISAM logic modules both with and without 
CORDATA=YES is only avoided if all or none of the ISAM files specify 
both SERVREQ=NEWREC and the IOSIZE operand in DFHFCT TYPE=DATASET. 

For furtner details on preparing logic modules, see the CICS/VS System 
Programmers Guide (DOS/VS) . 
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r- r- r -T, 

| j DFHFCT | TYPE=LOGICMOD | 

| | | C f RPS=SVA] | 


TYPE=LOGICMOD 

indicates that an ISAM logic module is to be created. 


RPS=SVA 

| indicates that the logic module to be generated is to use 

rotational position sensing. The use of RPS will depend on the 
device and the availability of GETVIS space, which can be 
allocated through the SIZE parameter of the // EXEC job control 
statement. For further information see D OS/VS Supervisor and 
I/O Macros . 

When this operand is specified, enough GETVIS space should be 
allocated for a DTF work area for each ISAM data set. If 
insufficient space is allocated, those ISAM data sets for which 
a DTF extension could not be acquired will be disabled when the 
first I/O request is issued. At that time the requesting 
transaction will be abnormally terminated with code AFCR. 

The user is responsible for ensuring that the FCT is link- 
edited with suitable ISAM logic modules for the conditions of 
execution. The diagnostic messages at the end of the FCT 
provide guidance. 


| REMOTE FILES — DFHFCT TYPE=REMOTE 


The DFHFCT TYPE-REMOTE macro defines the files that reside in a remote 
system that is participating in an intersystem communication session. 


r 

. r ... . 

r " r ^ T n 11 



j DFHFCT 

| TYPE=REMOTE 



i 

| ,DATAS ET=name 



i 

| ,SYSIDNT=name 



i 

j [,KE¥LEN=key-length] 



i 

j [,LRECL=record-length] 


L- 

i 

-L- 

j [,RMTNAME=name] 



TYPE=REMOTE 

indicates that this FCT entry identifies a file that resides in 
a remote system. 


DATASET=name 

indicates a 1 to 7 (DOS/VS) or a 1 to 8 (0S/VS) character name 
which is referred to by the application programs in the same 
system as this file control table. 


SYSIDNT=name 

specifies the name of the system in which the file is resident. 
The name given must be the same as that in the SYSIDNT operand 
in the DFHTCT TYPE=T SLINK macro or in an explicit remote 
request in an application program. 
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KEYLEN=key-length 

indicates the default key length for a file control request 
that is sent to a remote system. 


LRECL=record-length 

indicates the default data length (in bytes) for a READ WRITE 
or REWRITE request that is sent to a remote system. 

Further information on the key and data length values to be 
specified for remote systems can be found under the KEYLENGTH 
and LENGTH operands in the CICS/VS Application Programmer's 
Reference Manual (Command Level). 


RMTNAME=n ame 

indicates a 1- to 8-character name by which the file is known 
to the system in which it resides. If this operand is omitted 
(the normal case), the name specified in the DATASET operand 
will be used. RMTNAME allows two files, with the same name but 
in different systems, to be referenced. 


SEGMENTS OF A SEGMENTED RECORD — DFHFCT TYPE=SEGDEF 


Each segment of a segmented record is described by means of the DFHFCT 
TYPE=SEGDEF macro instruction. TYPE=SEGDEF must be generated for every 
segment in the record in the sequence in which it occurs within the 
record. Definition of the last segment must be followed by the 
TYPE= SEGLAST operand which must precede the coding of the TYPE=SEGSET 
operands to generate SEGSET=ALL automatically as the first segment 
pattern in the file control table. A maximum of 99 segments may be 
defined per record. 

r- r - r - 1 



j DFHFCT 

1 

TYPE= S EGD EF 



1 

1 

,SEGNAME=name 



1 

1 

,SEGLENG=length 



1 

1 

[.SEGCHAR=(CFIXEDI VARIABLE}. 



1 

1 

C BYTE|HALF|FULL | DOUBLE})1 



L-L-L-J 


TYPE=SEGDEF 

specifies segment definitions. 


SEGNAME=name 

specifies the eight-character symbolic name (label) of the 
segment. This operand must always be specified. 


SEGLENG=length 

specifies the length (in bytes) of the segment; up to 255 bytes 
can be specified (the length of the largest segment allowed). 

If the segment is variable length, this value represents the 
maximum length. This operand must always be specified. 


| SEGCHAR=f ormat 

indicates characteristics (format, alignment) of the segment. 
If one characteristic is to be specified, both must be 
specified. The default is SEGCHAR=(FIXED,BYTE). 
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FIXED 

indicates that the segment is 
VARIABLE 


indicates that the segment is 
byte of the segment indicates 

BYTE 


indicates 

HALF 

indicates 

FULL 

indicates 

DOUBLE 

indicates 


that the segment is 
that the segment is 
that the segment is 
that the segment is 


fixed length. 

variable length. The first 
the length of the segment. 

not aligned. 

halfword aligned. 

fullword aligned. 

doubleword aligned. 


HEADER OF SEGMENTED RECORD — DFHFCT TYPE=SEGHEAD 


If the records on a data set are segmented, the DFHFCT TYPE= SEGHEAD 
macro instruction defines for file management the header portion (root 
or control segment) of a segmented record. TYPE=SEGHEAD is the first of 
four operands which must be coded to specify segmented records. 


r - r - r - 

I IDFHFCT | TYPE=SEGHEAD 

j | | ,SEGLENG=length 

| j | ,INDDISP=number 

J j | t,TSEGIND=(BITI DISPLACEMENT)3 

L-L-l- 


I 

I 

I 

I 


TYPE=SEGHEAD 

specifies the header of a segmented record. 


SEGLENG=length 

specifies the length (in bytes) of the header portion (root 
segment) of the record. For VSAM variable length data sets, 
this length should include 4 bytes for an LLbfc field even 
though one does not exist on the data set. File management 
will create one after retrieving the physical record. This 
operand must always be specified. 


INDDISP=number 

provides the displacement of the segment indicator field 
relative to the beginning of the record (position zero). This 
does not include the length field for variable length VSAM data 
sets. This operand must always be specified. 


| TSEGIND=BIT|DISPLACEMENT 

specifies the type of segment indicator field that is contained 
in the root segment. The default is TSEGIND=BIT• 
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BIT 


specifies that segments are indicated by bits in the 
segment indicator field. 


DISPLACEMENT 

specifies that segments are indicated by displacements in 
the segment indicator field. 

It is the user's responsibility to maintain the segment 
indicator field. 


LAST SEGMENT SET — DFHFCT TYPE=SEGLAST 


The end of the segment definitions and the end of the segment set 
definitions are indicated by the DFHFCT TYPE=SEGLAST macro instruction, 
which must be generated immediately following the last macro segment 
definition (TYPE=SEGDEF) and immediately following the last segment set 
(TYPE= SEGSET) for a data set. If no DFHFCT TYPE=SEGSET macro 
instructions have been coded, a DFHFCT TYPE=SEGLAST macro instruction 
(to indicate the end of the segment sets) must immediately follow the 
DFHFCT TYPE=SEGLAST used to indicate the end of the segment definitions. 

This macro instruction generates SEGSET=ALL, which includes all the 
segments in the record, as the first entry in the segment set portion of 
the file control table. 


r-r-r-1 

| (DFHFCT | TYPE= SEGLAST | 

L-L-L-J 


TYPE= SEGLAST 

indicates the end of the segment definitions. 


SEGMENT SETS — DFHFCT TYPE=SEGSET 


The pattern of segments for a particular data set is described using the 
DFHFCT TYPE=SEGSET macro instruction. As many segment sets as desired 
may be specified. If the only segment set desired includes all the 
segments in the record, no DFHFCT TYPE=SEGSET macro instructions are 
necessary. A segment set of this type with a name of ALL is generated 
by the DFHFCT TYPE=SEGLAST macro instruction following the segment 
definitions. 


r-r-r- 

j (DFHFCT j TYPE=SEGSET 

| j | ,SEGSET=name 

j | | ,SEGNAME=(namelC,name2],...) 

t-L-L- 


1 


I 


J 


TYPE=SEGSET 

is to describe the segment sets. 
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SEGSET=name 

specifies the eight-character symbolic name (label) assigned to 
a particular pattern of segments. This label is used in coding 
the DFHFC macro instruction when segment services are required. 
The label may be the same as one of the segment names specified 
previously in a SEGDEF macro instruction but must be different 
from any other SEGSET name specified. The label ALL should not 
be used because CICS/VS automatically creates a universal 
segment set with this label. 


SEGNAME=name 

specifies the name of each segment to be included in the 
segment set f in the sequence in which the segment occurs in the 
segmented record. SEGNAME must be the same name as that 
specified in a previous DFHFCT TYPE=SEGDEF macro instruction. 


VSAM SHARED RESOURCES CONTROL — DFHFCT TYPE=SHRCTL 


The DFHFCT TYPE=SHRCTL macro instruction can be used to control the 
| sharing of VSAM resources by CICS/VS VSAM files and by IMS/VS VSAM data 
| bases under CICS/OS/VS and DL/I OS/VS. Because both the entry that 
describes the VSAM data set and the entry that controls the sharing of 
resources are referred to by the file control program whenever I/O is 
requested of a data set that is sharing resources, it may be desirable 
to group all data sets which share resources together in the file 
control table, along with the entry to control the sharing of resources. 
This will keep the number of pages required to perform I/O on any of 
these data sets to a minimum. 

| The DFHFCT TYPE=SHRCTL macro should follow the entries for the VSAM 
| data sets that are sharing resources. 

| If the file control table does not describe VSAM DL/I data sets, the 
j DFHFCT TYPE= SHRCTL macro need not be specified, because the CICS/VS- 
j supplied default version of the macro is suitable. 

| If one or more VSAM data sets indicate that they are to share 

resources and this macro instruction has not been issued prior to the 
DFHFCT TYPE=FINAL macro instruction, the entry necessary to control the 
sharing of resources is automatically generated with all values 
| defaulted. However, if VSAM DL/I data sets are described in the file 
| control table, the DFHFCT TYPE=SHRCTL macro must be specified with all 
j parameters present. 

Notes ; 

| 1. The VSAM shared resources facility for SVS require the appropriate 

j ICR to be installed. 

| 2. If CICS/OS/VS is being used with DL/I, the values specified in this 

j macro cannot be changed by the IMS/VS DFSVSAMP statement. 


r- 

~ r 

f* - * - — — — 

~ ~ 1 


j DFHFCT 

| TYPE=SHRCTL 



i 

i 

j t,BUFFERS=(size(count),.. .) ] 
j C ,KEYLEN=number ] 



i 

j I,RSCLMT=number] 



i 

j [,STRNO=number] 



t___L_L_-J 
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TYPE=SHRCTL 

specifies that the entry required to control the sharing of 
VSAM resources is to be generated. 


| BUFFERS=size 

is used to override part of the CICS/VS resource calculation. 
Each pair of values specifies a buffer size and a number of 
buffers of this size to be allocated. Each buffer size must be 
a power of 2, at least 512, or if greater than 2048, a multiple 
of 4096. The number of buffers of each size must be at least 3 
and less than 32768. If a given buffer size is not defined and 
it is required, the next larger buffer size will be used. When 
this parameter is specified, it overrides all of the buffer 
requirement calculation. What is specified in this parameter 
is exactly what will be passed to VSAM when the request is made 
to build the resource pool. If this parameter is not 
specified, CICS/VS will determine the buffer sizes required and 
the maximum number of buffers of each size and allocate the 
percentage specified or implied via the RSCLMT parameter. 


KEYLEN=number 

is used to override part of the CICS/VS resource calculation. 
It specifies the maximum key length of any of the data sets 
that are to share resources. If not specified, CICS/VS will 
determine the maximum key length. 


RSCLMT=number 

CICS/VS will calculate the maximum amount of resources required 
by the VSAM data sets that are to share resources. Because 
these resources are to be shared, some percentage of this 
maximum amount of resources must be allocated. This parameter 
is used to specify the percentage of the maximum amount of VSAM 
resources to be allocated. If this parameter is omitted, 50 
percent of the maximum amount of resources will be allocated. 

If both the STRNO= and BUFFERS= parameters are specified, 
RSCLMT= will have no effect. 


STRNO=number 

is used to override part of the CICS/VS resource calculation. 

It specifies the total number of strings to be shared among the 
data sets that are to share resources. The value must be at 
least one and not more than 255. If a number is not specified 
for STRNO, CICS/VS will determine the maximum number of strings 
and allocate the percentage specified or implied in the RSCLMT= 
parameter. IMS/VS users should ensure that the number 
specified in STRNO should be large enough to the number of 
strings specified in the DLTHRED operand (in DFHSIT) + 1 to be 
subtracted, or else CICS/VS will abend. 


I Note s Users of IMS/VS VSAM data bases should specify their own values 
| for the above parameters, and should not accept the default values 
j generated by CICS/VS. 
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END OF FILE CONTROL TABLE 


DFHFCT TYPE=FINAL 


The end of the file control table is indicated by the DFHFCT TYPE=FINAL 
macro instruction, which creates a dummy table entry to signal the table 
end. This macro instruction is the last statement in the assembly 
before the assembler END statement, except in CICS/DOS/VS where the user 
may also elect to code the DFHFCT TYPE=LOGICMOD macro instruction. 

r-r-r-1 

j |DFHFCT | TYPE=FINAL | 

L-L-L-J 


TYPE=FINAL 

indicates the end of the file control table. 


EXAMPLES 


| Figure 3.2-4 illustrates the coding that is required to create a file 
control table for three data sets. The first data set in the table is a 
cross-index data set that provides indirect access to a master data set 
and may reference a duplicate data set. The master data set requires 
segmenting services. 


DFHFCT TYPE=INITIAL START OF FILE CONTROL TABLE 

DFHFCT TYPE=DATASET, TABLE ENTRY FOR AN ISAM * 

DATASET=INDEX, DATA SET USED AS A CROSS- * 

ACCMETH=ISAM, INDEX DATA SET FOR A DATA SET * 

SERVREQ=(UPDATE, NAMED MASTER. * 

NEWREC, THIS DATA SET MAY BE * 

INDACC), UPDATED AND ADDED TO. * 

RECFORM=(FIXED,BLOCKED), * 

LRECL=37, * 

BLKSIZE=370, * 

BLKKEYL=5 

DFHFCT TYPE=INDACC, THIS DATA SET REFERENCES * 

OBiJDSID=MASTER, A DATA SET NAMED MASTER, * 

IARLKP—26, WHOSE KEY IS FOUND AT POSITION * 

IALKFL=11, 26. IT IS 11 CHARACTERS. * 

IADIII=FF, IT MAY POINT TO A DUPLICATES * 

DUPDSID=DUPLICA DATA SET NAMED DUPLICA. 

DFHFCT TYPE=DATASET, TABLE ENTRY FOR A BDAM * 

DATASET=DUPLICA, DUPLICATES DATA SET WHICH * 

ACCMETH=BDAM, CONTAINS KEYS TO THE MASTER * 

LRECL=22, DATA SET. IT IS A READ-ONLY * 

SERVREQ=(GET), DATASET. * 

RECFORM=(FIXED,UNBLOCKED), * 

BLKSIZE=22 


| Figure 3.2-4 (Part 1 of 2). 


File Control Table - Example 
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DFHFCT TYPE= DATASET, 

ACCMETH=(VSAM , KSDS), 
SERVREQ=(NEWREC , 
DELETE, 

UPDATE, 

BROWSE), 
DATASET=VSAMDS, 
STRNO=5, 

PASSWD=GUESS 


TABLE ENTRY FOR A VSAM 
DATA SET WHICH MAY BE 
UPDATED, ADDED TO, DELETED 
FROM, AND BROWSED. 


* 

* 

* 

♦ 

* 

* 

* 

* 


DFHFCT TYPE=DATASET, 

DATASET=MASTER, 

ACCMETH=ISAM, 

SERVREQ=(UPDATE, 

NEWREC, 

SEGMENT), 

RECFORM=(FIXED,BLOCKED), 
LRECL= 310, 

BLKSIZE=1550, 

RKP=11, 

BLKKEYL=5 


TABLE ENTRY FOR AN ISAM DATA 
SET WHICH MAY BE UPDATED AND 
ADDED TO, AND WHOSE RECORDS 
ARE SEGMENTED. 


* 

* 

* 

* 

♦ 

♦ 

* 

* 

♦ 

* 


DFHFCT 


DFHFCT 


DFHFCT 


DFHFCT 


DFHFCT 

DFHFCT 


DFHFCT 

DFHFCT 

DFHFCT 


TYPE=SEGHEAD, 
SEGLENG=20, 
INDDISP=2, 
TSEGIND=BIT 
TYPE=SEGDEF, 
SEGNAME=SEGMENT1, 
SEGCHAR=(FIXED, 
DOUBLE), 

SEGLENG=50 
TYPE=SEGDEF, 
SEGNAME=SEGMENT2, 
SEGCHAR=(VARIABLE, 
HALF) , 

SEGLENG=70 
TYPE= SEGDEF, 
SEGNAME=SEGMENT3, 
SEGLENG=45 
TYPE=SEGLAST 
TYPE= S EGSE T, 
SEGSET=PATTERNl, 
SEGNAME=(SEGMENT1, 
TYPE=SEGLAST 
TYPE=FINAL 
TYPE=LOGICMOD, 
RPS=SVA 
END 


SEGMENT HEADER DESCRIPTION 


SEGMENT #1 OF THE RECORD IS 
A FIXED-LENGTH, DOUBLEWORD 
ALIGNED FIELD. 


SEGMENT #2 OF THIS RECORD IS 
A VARIABLE LENGTH HALFWORD 
ALIGNED FIELD WHOSE MAXIMUM 

LENGTH IS 70 BYTES. 

SEGMENT #3 OF THE RECORD IS 
A FIXED-LENGTH UNALIGNED 
FIELD 

END OF SEGMENT DEFINITIONS 


SEGMENT3) 

LAST SEGMENT ENTRY FOR MASTER 
END OF FILE CONTROL TABLE 
CREATE DOS ISAM LOGIC MODULE 
UTILIZE RPS 


* 

* 

* 

* 

* 

* 

♦ 

♦ 

* 

* 

* 

* 

♦ 


* 

♦ 


| Figure 3.2-4 (Part 2 of 2).. File Control Table - Example 

| Figure 3.2-5 illustrates the coding required to generate file control 
table entries for VSAM KSDS and VSAM ICIP KSDS data sets. 
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DFHFCT TYPE=DATASET, TABLE ENTRY FOR A VSAM * 

DATASET=VSAM1, KSDS DATA SET * 

ACCMETH=(VSAM,KSDS), * 

SERVREQ=(GET,PUT,UPDATE,DELETE,NEWREC), * 

FILSTAT= C ENABLED,OPENED), * 

RECFORM=FIXED, * 

BUFSP=50000, * 

BUFNI=10, * 

BUFND=11, * 

STRNO=10, * 

PASSWD=LETMEIN 


| Figure 3.2-5 (Part 1 of 2). File Control Table VSAM KSDS Example 


DFHFCT TYPE=DATASET, TABLE ENTRY FOR A VSAM * 

DATASET=VSAM2, ICIP KSDS DATA SET * 

ACCMETH=(VSAM,KSDS), * 

SERVREQ=(GET,PUT,UPDATE), * 

FILSTAT=(ENABLED,OPENED), * 

RECFORM=FIXED, * 

BUFSP=50000, * 

BUFN1=8, * 

STRNO=15, * 

PASSWD=LETMEIN, * 

MODE=(ICIP), * 

INDEX=(VSAMIND1,1,INIT) , * 

DATA=VSAMDAT1 


| Figure 3.2-5 (Part 2 of 2). File Control Table ICIP KSDS Example 

| Figure 3.2-6 illustrates the coding required to generate a VSAM mixed 
mode file. Two consecutive DFHFCT macros are required, as follows: 


DFHFCT TYPE=DATASET, DEFINES THE VSAM CHARACTERISTICS* 


DATASET=VSAM3, OF A VSAM MIXED MODE FILE TO BE * 

ACCMETH=(VSAM,KSDS), OPENED INITIALLY IN ICIP MODE * 
SERVREQ=(GET,PUT,UPDATE,DELETE,NEWREC), * 

FILSTAT=(ENABLED,OPENED), * 

RECFORM=FIXED, * 

BUFSP=50000, * 

BUFNI=10, * 

STRNO=10, * 

PASSWD=LETMEIN, * 

MODE=(ICIP,MIXED) 

DFHFCT TYPE=ALTERNATE, DEFINES THE ICIP CHARACTERISTICS * 

DATASET=VSAM3, OF A VSAM MIXED MODE FILE * 

ACCMETH=(VSAM,KSDS), * 

SERVREQ=(GET,PUT,UPDATE), * 

FILSTAT=(ENABLED,OPENED), * 

RECFORM=FIXED, * 

BUFSP=50000, * 

BUFNI=8, * 

STRNO=15, * 

PASSWD=LETMEIN, * 

INDEX=(VSAMIND2,1,DYN), * 

DATA=VSAMDAT2 


| Figure 3.2-6. File Control Table VSAM and ICIP Definition of a Mixed 
Mode File 
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JCT 


JOURNAL CONTROL TABLE 


The journal control table (JCT) is the means by which the user describes 
journal data sets or files and their characteristics to CICS/VS for 
access through journal management. The JCT contains control information 
and operating system control blocks describing each of the journal 
files. For DOS/VS, the appropriate IOCS modules are assembled in the 
JCT. 


CONTROL SECTION -- DFHJCT TYPE=INITIAL 


The control section into which the journal control table is assembled is 
established by the DFHJCT TYPE=INITIAL macro instruction. This macro 
instruction must be coded as the first statement in the source deck used 
to assemble the journal control table. 

r-r-r-1 

| (DFHJCT j TYPE=INITIAL | 

I | | (,SUFFIX=xxJ | 

L-L- i-J 


TYPE=INITIAL 

establishes the control section into which the journal control 
table is assembled. 


SUFFIX=xx 

is a one- or two-character alphameric suffix for the journal 
control table being assembled. This suffix, if present, is 
appended to the standard module name (DFHJCT) which is used to 
name the module on the linkage-editor output library. 


| JOURNAL ENTRIES — DFHJCT TYPE=ENTRY 


Each journal referred to during CICS/VS execution must have a JCT entry 
as generated by the DFHJCT TYPE=ENTRY macro instruction. Chapter 4.6 of 
this manual contains tutorial information concerning the choice of 
operands and values for the JCT. 



TYPE=ENTRY 
,JFILEID={SYSTEM|nn) 

,BUFSIZE=nnnnn 
(,BUFSUV=nnnnn] 

C,JOUROPT=((CRUCIAL)(,PAUSE][,INPUT]t,RETRY])] 
[,JTYPE={ TAPEl 1 TAPE2(DISKI|DISK2}] 

(,OPEN=( INITIAL |DEFERRED}] 

For DOS/VS only 

(,DEVADDR=(SYSnnn(,SYSmmm])] 

(,JDEVICE={TAPE|2314(3330|3340(3350}] 


148 


CICS/VS System Programmers Reference Manual 









TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 


| JFILEID=SYSTEM|nn 

specifies the journal file identification for this entry. 
SYSTEM 

indicates that the journal being defined is the CICS/VS 
system log. This log is required if CICS/VS is to perform 
automatic logging of changes to CICS/VS resources to 
support the emergency restart facility. In this case, 

| JOUROPT=(CRUCIAL,INPUT) must be specified. The CICS/VS 

j system log must have an associated BUFSIZE value of at 

| least 1100 bytes if DL/I is used in CICS/OS/VS. 


nn 

is a decimal number between 2 and 99 which identifies the 
journal ID to be used. Leading zeros are not permitted. 


BUFSIZE=nnnnn 

specifies a decimal number indicating the number of bytes to be 
used as a buffer for journal I/O operations. The minimum is 72 
and the maximum is 32767 for tape, or the maximum track 
capacity for disk devices. For CICS/OS/VS, BUFSIZE must be the 
same value as the DCB BLKSIZE. For CICS/DOS/VS, if DL/I 
logging is being done through CICS/VS journaling, the maximum 
buffer size is 1024. 


B UF S UV= nnnnn 

specifies a decimal number to be used as a buffer shift-up 
value. The value must not be greater than the value specified 
for BUFSIZE. The default is the BUFSIZE value. 


| JOUROPT=option 

specifies which journaling option or options apply to the 
journal data set represented by this entry. 

CRUCIAL 

specifies that the journal data set is very important and, 
if it becomes inaccessible, CICS/VS is to be terminated. 

PAUSE 

specifies that if volume switching is required for a disk 
journal data set, a message is sent to the console operator 
to ask when this switch may proceed. If this option is not 
specified, the alternate extent will automatically be 
reused, thus overwriting the previous journal records. 

INPUT 

specifies that input operations are to be accepted for this 
journal data set. This option must be specified if 
emergency restart is required. 

RETRY 

specifies that output I/O errors are to be retried 
automatically on a new output volume before taking the 
action indicated by the CRUCIAL option. 
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| JTYPE^journal-type 

specifies the type of journal data set being defined. The 
default is JTYPE=TAPEl. 

TAPE1 

is a journal data set on one tape drive. 

TAPE 2 

is a journal data set on two tape drives. 

DISKI 

is a journal data set on disk which has one extent to be 
reused when full. 

DISK2 

is a journal data set on disk which has two extents to be 
used in a flip-flop manner. 


| OPEN= INITIAL |DEFERRED 

| specifies whether this journal file is to be opened by system 

I initialization. The default is OPEN=INITIAL. 

INITIAL 

indicates that the journal file is to be opened for output 
| by system initialization. 

DEFERRED 

| may be used for journals that are opened by transactions 

{ that are executing under CICS/VS, or by programs that are 

I specified in the program list table. 

Note : If the user wants to open a journal data set during 

execution, the VOLUME=FIRST parameter must be specified in 
the DFHJC TYPE=OPEN macro (see the section "Opening a 
Journal Data Set" in Chapter 4.6). 


For DOS/VS only 


| DEVADDR=address 

specifies the user*s logical unit address for the journal data 
set. 

SYSnnn 

specifies the logical unit address, where the nnn is a 
three-digit number from 000 to 255. 

SYSmmm 

specifies the alternate logical unit when two devices (tape 
or disk) are to be used for the journal data set. Like 
nnn, mmm is a three-digit number from 000 to 255 but cannot 
be equal to nnn. 


| JDEVICE=device 

specifies the device type on which the journal data set is to 
reside. The default is JDEVICE=TAPE. 
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END OF JOURNAL CONTROL TABLE — DPHJCT TYPE=FINAL 


The end of the journal control table is indicated by the DFHJCT 
TYPE=FINAL macro instruction. The assembler END statement must follow. 


|DFHJCT | TYPE=FINAL 

i_i_ 


TYPE=FINAL 

indicates the end of the journal control table. 


EXAMPLE 

| Figure 3.2-7 illustrates the coding to create a journal control table 
(JCT) for three journals: 

• The system log, allocated two tape drives 

• Journal identification 2, allocated one disk extent 

• Journal identification 3, allocated two disk extents 

Note : See the appropriate CICS/VS System Programmer*s Guide for 

execution-time JCL corresponding to this example. 


DFHJCT TYPE=INITIAL 

DFHJCT TYPE=ENTRY, ENTRY FOR * 

JFILEID=SYSTEM, SYSTEM LOG * 

JTYPE=TAPE2, TWO TAPE DRIVES ALLOCATED * 

BUFSIZE=1500, BUFFER SPACE IS 1500 BYTES * 

BUFSUV=1000, SHIFT UP POINT IS FULL * 

DEVADDR=(SYS004,SYS005), LOGICAL DEVICE ADDR * 

J OUROPT=(INPUT,RETRY,CRUCIAL) OPTIONS 

DFHJCT TYPE=ENTRY, ENTRY FOR * 

JFILEID=2, JOURNAL ID 2 * 

JTYPE=DISK1, ONE DISK EXTENT ALLOCATED * 

BUFSIZE=1500, BUFFER SPACE IS 1500 BYTES * 

BUFSUV=1500, AND ’SHIFT-UP' WILL NEVER OCCUR * 

JDEVICE=3330, JOURNAL DEVICE * 

DEVADDR=SYS0 06, LOGICAL DEVICE ADDR * 

J OUROPT= RETRY OPTIONS 

DFHJCT TYPE=ENTRY, ENTRY FOR * 

JFILEID= 3, JOURNAL ID 3 * 

JTYPE=DISK2, TWO DISK EXTENTS ALLOCATED * 

JOUROPT=(PAUSE,RETRY), OPTIONS * 

JDEVICE=2314, JOURNAL DEVICE * 

DEVADDR=(SYS006,SYS007), LOGICAL DEVICE ADDR * 

BUFSIZE=1000 BUFFER SPACE IS 1000 BYTES * 


* SHIFT-UP VALUE DEFAULTS TO BUFSIZE * 

DFHJCT TYPE=FINAL 
| END 

| Figure 3.2-7. Journal Control Table - Example 
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NLT 


NUCLEUS LOAD TABLE 


The nucleus load table has been provided to enable the CICS/VS user to 
utilize virtual storage efficiently. The table is used by CICS/VS to 
control the load order of the CICS/VS nucleus. It allows the CICS/VS 
user the option of changing the default load order established by the 
CICS/VS system initialization program. 

The modules specified in the nucleus load table are loaded in the 
order and at the relative location specified in each DFHNLT TYPE=ENTRY 
instruction. When all specified modules have been loaded, a default 
list is used to load the remaining modules. The default nucleus load 
table is contained in the system initialization module DFHSIBl. This 
module would be a good reference for any installation considering 
altering the default list. 

The default load order for CICS/DOS/VS and CICS/OS/VS is shown below. 


CICS/DOS/VS 


ADDRESS 

SPACE 

LOW 


MODULE 

OPTION 

FUNCTION 

DFHTCT 


Terminal Control Table 

DFHCSA 

ALIGNED 

Common System Area 

DFHKCP 

ALIGNED 

Task Control Program 

DFHEIP 


EXEC Interface Program 

DFHSPP 


Sync Point Program 

DFHZCP 

ALIGNED 

Terminal Control Common Interface 

♦DFHZCA 


VTAM Terminal Control Program 

♦DFHZCB 


VTAM Terminal Control Program 

♦DFHTCP 


BTAM Terminal Control Program 

DFHZCX 


BTAM and VTAM Terminal Control Program 

♦DFHZCY 


VTAM Terminal Control Program 

♦DFHZCZ 


VTAM Terminal Control Program 

DFHSCP 

ALIGNED 

Storage Control Program 

DFHPCT 

ALIGNED 

Program Control Table 

DFHPCP 

ENTRY AL'D 

Program Control Program 

DFHPPT 

ALIGNED 

Processing Program Table 

DFHFCT 

ALIGNED 

File Control Table 

♦DFHSDAM 


Direct Access Table 

DFHFCP 


File Control Program 

DFHTSP 

ALIGNED 

Temporary Storage Control Program 

♦DFHTST 


Temporary Storage Table 

DFHDCT 

ALIGNED 

Destination Control Table 

DFHTDP 


Transient Data Program 

♦DFHIIP 

ALIGNED 

Basic Mapping 

♦DFHM32 


Basic Mapping 

DFHMCP 


Basic Mapping 

♦DFHTPP 


Basic Mapping 

♦DFHDSB 


Basic Mapping 

♦DFHPBP 


Basic Mapping 


CICS/VS DYNAMIC STORAGE AREA 
AND 

CICS/VS APPLICATION PROGRAM AREA 

♦DFHTRT HIGH Trace Table 
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ADDRESS MODULE OPTION FUNCTION 

SPACE 

DFHTRP AL*D HIGH Trace Control Program 

DFHFDP AL*D HIGH Formatted Dump Program 

DFHSCR AL* D HIGH Storage Control Recovery 
DFHKPP AL"D HIGH Keypoint Program 

♦DFHSRT HIGH System Recovery Table 

DFHSRP AL*D HIGH System Recovery Program 

| +DFHMGT HIGH Message Table 

I +DFHMGP AL"D HIGH Message Program 

j +DFHISP HIGH Intersystem Communication Program 

I *DFHXFP HIGH Intersystem Transformer Program 

j *DFHELR AL"D HIGH Intersystem EXEC Local/Remote Program 

| DFHLFO HIGH LIFO Storage Program 

j DFHDCP AL"D HIGH Dump Control Program 

DFHDIP AL* D HIGH Batch Data Interchange Program 
♦DFHSAP AL* D HIGH Storage Acquisition Program 
DFHBFP AL"D HIGH Built-In Functions 

♦DFHRLR AL f D HIGH Basic Mapping Route List 
♦DFHF2P HIGH Faster COMPAT 

♦DFHFIP AL* D HIGH Faster COMPAT 

♦DLZNUC AL*D HIGH DL/I Nucleus Module 

♦DFHJCOCP HIGH Journal Open/Close 

♦DFHJCT HIGH Journal Control Table 

DFHJCP AL"D HIGH Journal Control Program 
DFHICP AL"D HIGH Interval Control Program 
| HIGH DFHALT HIGH Application Load Table 


For CICS/OS/VS i the modules are loaded from high address space to low 
address space. The default load order is as follows: 


CICS/OS/VS 


ADDRESS MODULE OPTION FUNCTION 

SPACE 


HIGH 


DFHCSA 

DFHKCP 

DFHSPP 

DFHICP 

DFHZCP 

♦DFHTCP 

DFHTCT 

DFHSCP 

DFHJCP 

♦DFHJCT 

DFHPCT 

DFHPCP 

DFHPPT 

DFHFCP 

DFHFCD 

♦DFHFCT 

♦DFHDLI 

♦DFHDMB 

♦DFHPSB 

DFHTSP 

♦DFHTST 

DFHTDP 

♦DFHDCT 

♦DFHIIP 

♦DFHFIP 


ALIGNED Common Systems Area 

ALIGNED Task Control Program 

Sync Point Program 
ALIGNED Interval Control Program 

Terminal Control Common Interface Program 
Terminal Control Program (non-VTAM) 
Terminal Control Table 
ALIGNED Storage Control Program 

Journal Control Program 
Journal Control Table 
Program Control Table 
ENTRY AL* D Program Control Program 
Processing Program Table 

File Control Program - common subroutines 

File control module for ISAM/BDAM 

File Control Table 

DL/I Interface Program 

DMB Directory CDL/I) 

PSB Directory (DL/I) 

Temporary Storage Program 
Temporary Storage Table 
Transient Data Program 
Destination Control Table 
Basic Mapping 
FASTER/Compat Program 
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FUNCTION 


ADDRESS MODULE OPTION 
SPACE 

♦DFHM32 
DFHMCP 
♦DFHTPP 
♦DFHDSB 
♦DFHPBP 
♦DFHRLR 
♦DFHF2P 
DFHBFP 
DFHDIP 
♦DFHSAP 
DFHSCR 
DFHDCP 
DFHSRP 
♦DFHSRT 
DFHKPP 

DFHFDP ALIGNED 
DFHTRP 
♦DFHTRT 

LOW 

Note: The modules listed above with a preceding asterisk (*) are not 

loaded if the facility is not specified. 

The CICS/VS default nucleus load tables are designed to give good 
performance across a wide range of applications and generation options. 
Changes to the default load order should be carefully considered, as 
improper use of the nucleus load tables can result in reduced 
performance. For example, the program control program (DFHPCP) is 
structured so that the working set instructions are at the end of the 
module following the entry point of the module. Thus, if DFHPCP is 
loaded (as in the default load order) immediately before the processing 
program table (DFHPPT) and the ALIGN=ENTRY option is specified, the 
working set of DFHPCP will be loaded in the same page as the most-used 
portion of DFHPPT. This will reduce page-faults because DFHPCP uses 
DFHPPT more often than any other system table. 

The default nucleus load table attempts to provide the best working 
set arrangement for CICS/VS. However, because of the many options 
available in CICS/VS, it may be possible for an installation to improve 
on the default loading of the nucleus. Before altering the default load 
order, the system programmer should consider carefully not only the 
module to be moved but also the effect on the neighboring modules. 
Modules may be loaded adjacently because of their inter-related function 
or reference (for example, KCP and SPP). Care should be used in 
aligning modules because inadvertent choices can add to the working set 
rather than reduce it (for example, specifying ALIGN for both the PPT 
and the PCP would increase its working set). Alignment of modules can 
be used to isolate little-used functions (for example, aligning DCP) or 
to locate the working set of a module in as few pages as possible (for 
example, aligning SCP). 

Each installation should study its requirements carefully, and then 
use the nucleus load table (if necessary) to order the CICS/VS nucleus 
into a configuration to suit its needs. 

The purpose of the nucleus load table is to tailor the nucleus load 
to create a load order which provides the user with the smallest 
possible working set for the CICS/VS nucleus. 

The nucleus load table is an optional feature of CICS/VS. The 
nucleus load table to be used is specified in the system initialization 


Basic Mapping 3270 

Basic Mapping Control 

Basic Mapping 

Basic Mapping 

Basic Mapping Page Build 

Basic Mapping Route List 

Basic Mapping FASTER/Compat 

Built-in Functions 

Batch Data Interchange Program 

Storage Acquisition (PL/I) 

Storage Recovery Program 

Dump Control Program 

System Recovery Program 

System Recovery Table 

Keypoint Program 

Formatted Dump Program 

Trace Control Program 

Trace Table 
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table. If the nucleus load table specification is "NO " 9 the default 
load order will be used. 


CONTROL SECTION — DFHNLT TYPE=INITIAL 


The control section name for the nucleus load table is established by 
the DFHNLT TYPE=INITIAL macro instruction. This macro instruction also 
creates the necessary linkage editor control for subsequent link¬ 
editing . 


r r r - 

j j DFHNLT j TYPE=INITIAL 

j j | [ f SUFFIX=xxl 

L-L-L——- 


‘1 

I 

I 


J 


TYPE=INITIAL 

establishes the control section into which the nucleus load 
table is to be assembled. 


SUFFIX=xx 

specifies a one- to two-character suffix for the nucleus load 
table being assembled. The suffix is appended to the basic 
name (DFHNLT) and used to name the module on the linkage editor 
output library. 


MODULE LOAD SEQUENCE — DFHNLT TYPE=ENTRY 


A specific nucleus module is defined to CICS/VS. Included in this 
definition is the information about where the module is to be loaded and 
the options with which the module is to be loaded. 

The DFHNLT TYPE=ENTRY macro instruction is used to specify the module 
load sequence. 


r 

1 

1 

1 

1 

I 

r 

j DFHNLT 

1 

1 

1 

i 

r j —-—---— —— 

| TYPE=ENTRY 
j f MODULE=name 
j ( f ALIGN={NO|YES|ENTRY}) 
j [,FIX=CNO|YES}] 
j 

---1 

1 

1 

1 

1 

1 

1 

1 For DOS/VS Only 
j 


1 

1 

1 

1 

L_ _ 

1 

1 

1 

1 

L rr 

| {. ADRSPCE={LOW 1 HIGH}] 

j l, PAGEIN={NO | YES} ] 
j [ ,PAGEOUT={NO J YES} ] 

. L - - . 

J 

TYPE= 

: ENTRY 




specifies that an entry is to be specified in the nucleus load 
table. 
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| MODULE-name 

specifies the nucleus module name. The name specified should 
be the basic module; suffixes are not required and will be 
ignored. 


| ALIGN=NO|YES|ENTRY 

specifies whether any page alignment of the module is to be 
performed. Page alignment will only occur for the module(s) 
specified; all other modules will be packed in contiguous 
address space. The default is ALIGN=NO. 

NO 

specifies no page alignment. 

Note that when ADRSPCE=HIGH is specified for DOS/VS f the 
end of the module is placed at the highest available 
address. 

YES 

specifies that the beginning of the module is to be page- 
aligned to the start of a page, or that the end of the 
module is to be page-aligned to the end of a page if 
ADRSPCE=HIGH (DOS/VS only) is specified, when the module is 
loaded. (In CICS/VS Version 1, Release 2, aligned modules 
were loaded in high address space so that they started on a 
page boundary.) The current implementation allows 
infrequently used modules and tables to be packed onto the 
same page. For example, specifying DFHJCP,ALIGN=YES and 
DFHJCT,ALIGN=NO packs the two modules onto the same page 
with DFHJCP aligned on a page boundary. 

ENTRY 

specifies that the entry point of the module will be 
aligned on a page boundary when ADRSPCE=LOW is specified. 
This is useful when the working set of the module follows 
the module entry point and the entry point is not at the 
start of the module (see the note on DFHPCP in the section 
"Nucleus Load Table" above). 

Note : The ALIGN option should be used with care to optimize 

the size of the CICS/VS working set. Modules considered to be 
part of the normal CICS/VS working set should not normally be 
page-aligned, because page alignment may force wasted address 
space. Example: A task control program always references the 
common system area (CSA). Packed into contiguous address 
space, this would normally occupy three 2K pages. If, however, 
both are page-aligned, four 2K pages would be used. 


| FIX=NO|YES 

specifies that the module is to be page-fixed in real storage. 
Use of page-fixing should be carefully considered. Unnecessary 
page-fixing will only reduce the available real storage for 
paging and will probably adversely affect performance of both 
CICS/VS and concurrent batch work. If FIX=YES is specified, 
CICSSVC must be specified in the DFHSG TYPE=INITIAL macro. The 
default is FIX=NO. 

NO 

indicates that page-fixing is not required. 

YES 

indicates that the module is to be page-fixed. 
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Note ; The options of ALIGN, PAGEIN, and PAGEOUT have no 
meaning for a module which is fixed, and will be ignored if 
this operand is specified. 


For DOS/VS only 


| APRSPCE= LOW|HIGH 

specifies the partition area into which the module is to be 
loaded. LOW is the default. 

LOW 

specifies that the module is to be loaded at the low end of 
the partition. Modules normally included in the CICS/VS 
working set should be loaded low to optimize use of the 
page data set (examples are DFHKCP, DFHTCP, and DFHCSA)• 


HIGH 

specifies that the module is to be loaded at the high end 
of the partition. Modules not normally to be included in 
the CICS/VS working set should be specified to be loaded 
high (examples are DFHDCP and DFHSRP). 


| PAGEIN=NO j YES 

indicates whether the module is to be added to a page-in list. 
The page-in list will be used to initiate a page-in operation 
each time CICS/VS regains control after a DOS/VS WAIT initiated 
by the task control program (KCP). The default is PAGEIN=NO. 

NO 

indicates that the module is not to be added to a page-in 
list. 


YES 

indicates that the module will be added to a page-in list. 

Note : PAGEIN may be very useful in a low message rate system 

with concurrent batch operation, and all of the CICS/VS 
critical working set should be included. However, in a 
dedicated system, PAGEIN will cause additional processor 
utilization and its use should be avoided. 

Use of PAGEIN in a very active CICS/VS (high message rate) 
system should be carefully evaluated. 

PAGEIN=YES may not be specified for modules specified with 
ADRSPCE=HIGH• 


| PAGEOUT=NOI YES 

indicates whether the module is to be included on a page-out 
list. The page-out list will be used by the task control 
program to initiate page-out operations immediately before 
issuing a DOS/VS WAIT. This will make those pages available 
for use by concurrent batch jobs. The default is PAGEOUT=NO. 

NO 

indicates that the module is not to be added to a page-out 
list. 
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YES 


indicates that the module will be added to a page-out list. 

Note : Normally, only those modules not considered part of the 

CICS/VS working set should be included on the page-out list 
(examples are DFHDCP, DFHSRP, and DFHSCR). The trace program 
and table should not specify PAGEOUT=YES, because if trace is 
activated, these programs become highly referenced. 


END OF NUCLEUS LOAD TABLE — DFHNLT TYPE=FINAL 


The end of the nucleus load table is indicated by the DFHNLT TYPE=FINAL 
macro instruction, which is the last statement in the assembly of the 
nucleus load table before the assembler END statement- This macro 
creates a dummy entry to signal the table-end. 

r - r - r - 1 

| |DFHNLT | TYPE=FINAL | 

L-L-.-L-J 


TYPE=FINAL 

indicates the end of the nucleus load table. 


EXAMPLES 


In general, CICS/DOS/VS installations should place unused or little-used 
pageable modules into the high address space of the partition. With 
only the heavily-used programs in low address space, the seek-time on 
the page data set for these modules will be reduced. This is due to the 
organization of the page data set in DOS/VS. 

Example 1 illustrates a nucleus load table (Figure 3.2-8) for an 
installation with the following characteristics: 

• Some CICS/VS services are not used (journal control program, 
interval control program, built-in functions, and keypoint 
program). 

• Some CICS/VS services (transient data control and dump control 
programs) are used only for error conditions or for a small 
percentage of application programs. 

• Trace program facilities normally off. 

• Concurrent batch processing. 

The entry for the DFHSDAM with ADRSPCE=HIGH indicates (for CICS/DOS/VS 
only) the assumption that no direct access files are defined in the file 
control table (FCT). 
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The DFHTRT does not specify alignment. If the trace table is specified 
as aligned, system initialization will round the trace table number of 
entries to fill a whole number of pages. Therefore, if it is desirable 
to force TRP and TRT into an integral number of pages, it must be done 
by aligning TRP (ALIGN=YES) and calculating the TRT size without 
specifying alignment. The TRT size specification given in the system 
initialization table (or as a start-up override) should be calculated to 
round-up the TRP alignment to even-page multiples. The number of trace 
table entries can be calculated by the following formulae: 


| CICS/DOS/VS 


AUX=NO 

T= 

128 

(N-l) 

+ 

15 

AUX=TAPE 

T= 

128 

(N-4) 

+ 

110 

AUX=2314 etc 

T= 

128 

(N-4) 

+ 

80 


| CICS/OS/VS 


I DLI= AUX= 


NO 

NO 

T= 128 

(N-l) 

+ 

11 

NO 

YES 

T= 128 

(N-4) 

+ 

76 

YES 

NO 

T= 128 

(N-l) 

+ 

4 

YES 

YES 

T= 128 

(N-4) 

+ 

68 


where T is the number of trace entries, and N is the number of pages 
(2K) devoted to the trace program. 

In an installation using the same facilities as Example 1 (below), 
but in a dedicated environment, the nucleus load table would be the same 
| as in Figure 3.2-8, except that PAGEIN and/or PAGEOUT should not be 
specified. 


Chapter 3.2. DFHNLT Examples 


159 



DFHNLT TYPE-INITIAL 

DFHNLT TYPE=ENTRY , * 

MODULE=DFHJCP, * 

ADRSPCE=HIGH, * 

P AGEO (JT= YE S 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHICP, * 

ADRSPCE=HIGH, * 

PAGEOUT=YES 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHBFP, * 

ADRSPCE=HIGH, * 

PAGEDUT=YES 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHKPP, * 

ADRSPCE=HIGH, * 

PAGfiOUT=YES 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHSRP, * 

ADRSPCE=HIGH , * 

PAGEOUT= YE S 

DFHNLT TYPE=ENTRY, * 

MODULE= DFH SCR , * 

ADRSPCE=HIGH , * 

PAGEOUT=YES 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHTDP , * 

ADRSPCE=HIGH, * 

ALIGN=YES, * 

PAGEOUT=YE S 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHSDAM, * 

ADRSPCE=HIGH, * 

PAGEOUT= YE S 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHTRP, * 

ADRSPCE=HIGH, * 

ALIGN=YES 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHTRT, * 

ADRSPCE= HIGH 

DFHNLT TYPE=FINAL 

END 


| Figure 3,2-8. Nucleus Load Table - Example 1 


| Example 2 illustrates a nucleus load table (Figure 3.2-9) for an 
installation with the following characteristics; 

• Some CICS/VS services are not used (temporary storage control 
program, basic mapping support, and built-in functions). 

• Normal usage of all other CICS/VS facilities. 
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DFHNLT 

TYPE=INITIAL 


DFHNLT 

TYPE=ENTRY, 

♦ 


MODULE=DFHTSP, 

ADRSPCE= HIGH 

* 

DFHNLT 

TYPE=ENTRY, 

* 


MODULE=DFHBFP, 

ADRSPCE=HIGH 

* 

DFHNLT 

TYPE=ENTRY, 

* 


MODULE= DFHMCP, 

ADRSPCE=HIGH 

* 

DFHNLT 

END 

TYPE=FINAL 



| Figure 3•2-9. Nucleus Load Table - Example 2 

In an installation which is using the same facilities as in Example 2 # 
except where there is potential interference from batch processing, the 
approach taken would be to specify PAGEIN for all modules which are part 
of the CICS/VS critical working set. 


PCT -- PROGRAM CONTROL TABLE 


The program control table contains the control information to be used by 
CICS/VS for identifying and initializing a transaction. Task control 
uses a portion of each PCT entry to accumulate transaction statistics. 
This table is required by CICS/VS to verify the incoming transaction 
request, and to supply information about the transaction such as the 
transaction priority, the security key, and the length of the 
transaction work area. 

| The following macro instructions may be specified in a program 
| control tables 

• DFHPCT TYPE=INITIAL, which establishes the control section 

• DFHPCT TYPE=ENTRY, which specifies the transaction control 
information 

| • DFHPCT TYPE=GROUP, which simplifies the specification of the 

I transaction entries for CICS/VS-supplied transactions. 

• DFHPCT TYPE=OPTGRP, which specifies the transaction description 
options 

• DFHPCT TYPE=FINAL, which concludes the program control table. 


CONTROL SECTION — DFHPCT TYPE=INITIAL 


The control section into which the program control table is assembled is 
established by the DFHPCT TYPE=INITIAL macro instruction. 


i 

i 

i 



TYPE=INITIAL 
[,DTB=tNO|YES|(YES,NO)}] 

(,FDUMP=((ASRAJ(,ASRB])3 
(,INDEX=CNO|YES}] 

[,SCRNSZE={ DEFAULT I ALTERNATE}] 
(,SUFFIX=xx] 
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TYPE=INITIAL 

establishes the control section into which the program control 
table is assembled* 


DTB=NO|YES|(YES,NO) 

indicates whether all entries in the PCT will require the 
dynamic transaction backout facility. The option specified in 
this macro can be overridden by that in the DFHPCT TYPE=ENTRY 
macro. Because a dynamic transaction backout buffer is not 
acquired until a protected resource is modified, the overheads 
involved for DTB=YES for a transaction that never modifies a 
protected resource are negligible. The default is DTB=NO. 


NO 

indicates that the dynamic transaction backout facility is 
not required. 

YES 

indicates that the dynamic transaction backout facility is 
required for all the entries in this PCT. 

(YES,NO) 

indicates, for an intersystem communication session, that 
normal dynamic transaction backout facilities are required 
except when the session fails at a critical time during 
sync point or return processing. For full details on 
recovery for intersystem communication sessions, refer to 
the CICS/VS System/Application Design Guide . 


| FDUMP=ASRA,ASRB 

indicates the default value for the FDUMP (formatted dump) 
operand if the corresponding operand is not specified in a 
DFHPCT TYPE=ENTRY macro for this PCT. 

ASRA,ASRB 

indicates that a formatted dump will be taken after program 
interrupts and operating system abends. 


INDEX—YES|NO 

specifies whether indexing is to be used. In some 
circumstances, indexing reduces the processor cycles required 
to search CICS/VS tables by shortening the scan to locate 
entries. It also reduces the CICS/VS working set for large 
tables by reducing references to little-used or unused pages. 
Refer to the appropriate CICS/VS System Programmer"s Guide for 
further details. The default is INDEX=NO. 

YES 

indicates that indexing is to be used. When this option is 
specified, the entries in the PCT will be listed 
alphabetically by transaction-identification name. 

INDEX=YES must be specified when XTRANID, TRANSID, or 
TASKREQ are used in any one DFHPCT TYPE=ENTRY macro. 
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NO 

indicates that indexing is not to be used. In this case, 
the PCT entries will be scanned sequentially; the most 
frequently used entries should be specified near the start 
of the table. 

Note ; Page-indexing (the former PAGENXD operand) is no longer 
supported. However, if PAGENXD=YES is specified and the INDEX 
option does not appear, the entries will be treated as if 
INDEX=YES were specified. 


S CRNS 2 E= DEFAULT I ALTERNATE 

selects one of the two screen sizes (defined in the DFHTCT 
TYPE=TERMINAL macro) to be used for all the entries in the 
program control table that are not specified individually in 
DFHPCT TYPE=ENTRY macros. The default is DEFAULT. This 
operand also selects the buffer size for printers using a 3270 
data stream. For further information on the choice of screen 
sizes and buffer sizes, refer to the ALTSCRN and DEFSCRN 
operands in DFHTCT TYPE=TERMINAL. 

DEFAU LT 

indicates that transactions will be run in default screen 
size mode, using the values from the DEFSCRN operand in 
DFHTCT TYPE=TERMINAL. 

ALTERNATE 

indicates that transactions will be run in alternate screen 
size mode, using the values from the ALTSCRN operand in 
DFHTCT TYPE=TERMINAL. 


SUFFIX=xx 

specifies a one- or two-character alphameric suffix for the 
program control table being assembled. This suffix, if 
specified, is appended to the standard module name (DFHPCT) and 
is used to name the module on the linkage editor output 
library. If this operand is omitted, a suffix is not provided. 


TRANSACTION CONTROL INFORMATION — DFHPCT TYPE=ENTRY 


Transaction control information is provided to CICS/VS storage 
| management services by the DFHPCT TYPE=ENTRY macro instruction. One 
TYPE=ENTRY macro must be generated for each transaction. Information 
provided by this macro instruction includes priority, security key, 
program identification, purge indicators, and size of the transaction 
work area. 

| Some CICS/VS-supplied transactions must have entries in the PCT. 
j Refer to Appendix A for a list of these required entries. 

When generating PCT entries for transactions, the system programmer 
may specify certain options for the transaction which relate to message 
protection and automatic journaling of terminal messages. In addition, 
a particular transaction may be restricted to run only on logical units. 
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DFHPCT 


TYPE=ENTRY 
,PROGRAM=name 
, TASKREQ=XXXX 
, TRANSID=transaction-id 
[,ANTICPG={NO|YES|nn}3 
[,CLASS={LONG|SHORT}3 
{,COMPAT={NO|FORMAT|FULLBUF}3 
[,DTB={NO|YES|(YES,NO)}} 

(,DTIMOUT={NOInumeric-value}} 

[,DUMP={YESINO> 3 

[,DVSUPRT={ ALL |VTAM|NONV}3 

(,FDUMP=([ASRA3[,ASRB3)3 

[,PRIVATE={NOI YES}3 

[,RESTART={NO|YES}3 

[,RMTNAME=name 3 

[,RTIMOUT={NO|numeric-value}3 

t,SCRNSZE={DEFAULT|ALTERNATE}3 

(,SPURGE={NO|YES}3 

{,SYSIDNT=name3 

t,TCLASS={NO|task-class}3 

[,TPURGE={NOjYES}3 

[,TRANSEO= {11decimal-value}3 

[,TRNPRTY={1|decimal-value}3 

[,TRNSTAT={ ENABLED |DISABLED}3 

[,TWASIZE={0|decimal-value}3 

{ , XTRANID=hexadecimal-transaction-id3 

VTAM only 

t,INBFMH={ EODS IALL|NO|DIP}3 
[,JFILEID={NO|SYSTEM|nn}3 
( ,LOGREC={NO IYES3 3 
[,MSGJRNL=(INPUT,OUTPUT)3 
t,NEPCLAS=integer3 
l ,OPTGRP=name3 
[,TIOTYPE={ DELAY |IMMED}3 

OS/VS only 

t,PRMSIZE=decimal-value} 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 


PROGRAM=name 

specifies the initial program identification; this operand 
specifies the name of the program to which control is to be 
given to process this transaction. This program must also be 
defined in the PPT. 
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TASKREQ= xxx 

| specifies one of the special PA or PF keys, the operator 

| identification card reader (OPID), or the light pen attention 

| field on a 3270. Specifying this parameter indicates that a 

| transaction is to be initiated in response to the operator 

j striking one of these special keys, reading the operator 

j identification card, or selecting a light pen attention field 

| (LPA). Valid specifications are: PAl, PA2, PA3, PF1 through 

| PF24, OPID, and LPA. 

| Either TASKREQ or TRANSID or both operands must be specified, 

j XTRANID may be specified with either or both operands. 

Note : There are several, possibly conflicting, uses of the 

3270 PA/PF keys. In order of interpretation these uses are: 

| 1. To initiate printing, as specified in the PRINT operand of 

the DFHSIT macro or at system start-up. Once so defined, 
the key cannot be used for any other purpose. 

2. To initiate a transaction, as specified in the TASKREQ 
operand above. The same key can also be used for purpose 3 
below. 

3. For page retrieval, as specified in the SKRxxxx operand of 
the DFHSIT macro. The same key can also be used for 
purpose 2 above; it is interpreted as a page retrieval 
function only during a page retrieval session. As a 
special case, if PROGRAM=DFHTPR and TASKREQ=xxx are 
specified in the DFHPCT TYPE=ENTRY macro, the key will also 
open the page retrieval session. 


TRANSID=transaction-id or "transaction-id* 

specifies the one- to four-character transaction identification 
assigned to the individual transaction. Transaction 
identifications beginning with the letter "C" are reserved for 
CICS/VS; see the current list in Appendix A. 

The following rules apply when specifying the TRANSID operand: 

• If the operand begins and ends with apostrophes, it is 
assumed that they are only framing characters. They will 
not become part of the actual character string in the PCT 
entry. 

• If an ampersand (S) or an apostrophe (*) is required as one 
of the characters for the TRANSID specification, two 
ampersands or apostrophes must be specified where the one 
is required. The assembler converts these double 
characters into single ones. 

• The resultant length of the TRANSID after the above point 
must not exceed four characters. 

• If the special characters "(" or ")" are required as 

part of the TRANSID, the framing apostrophes must be used. 

• The special character "blank" (X*40*) must not be one of 
the TRANSID characters, because DFHTCP treats a blank as a 
delimiter when looking for a four-character TRANSID. 
Equally, the characters specified as field separators or 
field start characters in the FLDSEP and FLDSTRT operands 
of DFHSIT may not be used. 
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• If an apostrophe is the first or last character of the 
TRANSID, the whole TRANSID operand must be enclosed in 
apostrophes (that is, it must begin and end with three 
apostrophes). 

Examples of valid TRANSID specifications ares 


TRANSID Specified 


TRANSID Value 


ABCD ABCD 

'ABCD* ABCD 

66ABC £ABC 

£ 66666 ££ ££££ 

« l» I* IV » I » '» » f f • '■ V 

• . <v .» V . i I *« 

IB A,BC B A,BC 

f AB B,B!B * AB * 


Examples of invalid specifications are: 


•ABC 
£ABC 
,B AbBC * 
A,BC 


unpaired apostrophe 
unpaired ampersand 
embedded blank 
without the 
framing apostrophes 
the value is simply "A" and 
"BC" becomes the next macro 
operand. 


Notes: 


1. The transaction identification may take 
any of the following forms: 


4 characters followed by data 
1-4 characters (no data) 

1-4 characters followed by a blank and then data 
1-3 characters followed by a field separation character 
(specified by FLDSEP in the SIT) 

1-3 characters followed by a field name start character 
(specified by FLDSTRT in the SIT) 

2. TRANSID=DISC should not be specified if terminals are to 
be supported on switched lines. 

The 3287 printer includes Program Access keys (PA1 and PA2), 
which are only available when the 3287 is operating as an SNA 
SCS printer (TRMTYPE=SCSPRT). Pressing one of these keys may 
generate an inbound data stream that consists of the characters 
"APAK 01" or "APAK 02" for PA1 and PA2 respectively. When a 
transaction is not currently attached to a printer, the PA1 and 
PA2 keys can be made to initiate a transaction by specifying 
TRANSID=APAK as the transaction name. For further information 
on the use of Program Access keys on the 3287, refer to the 
3270 Information Display System Components Description manual. 


| ANTICPG=nnI YES I NO 

specifies whether anticipatory paging is to be performed on the 
task control area (TCA), the data areas, and on the application 
program code. The default is ANTICPG=NO. 
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nn 

specifies a decimal value from 1 through 15 to indicate the 
number of consecutive pages which are to be initially 
acquired for the task's TCA and data areas, and to be paged 
in and out asynchronously. 

YES 

indicates that one page is to be acquired initially. 

no ’ 

indicates that anticipatory paging is not #6 be performed. 

Notes: 

1. ANTICPG=nn and ANTICPG=YES require the CICSSVC operand in 

the DFHSG TYPE=INITIAL macro. < 

2. In DOS/VS, unused pages at the "high end" of anticipatory 
paging storage for an isolated task (one which is specified 
with PRIVATE=YES or CLASS=LONG) are not paged in or out. 
This is significant because DOS/VS will not acquire real 
storage for unused pages. OS/VS is aware, through its page 
tables, that certain pages have not been used* 


| CLASS= LONG I SHORT 

defines the relative longevity of the task initiated by the 
defined TRANSID. CICS/VS treats each task class in a manner 
which minimizes page faults occurring during the processing 
life of the task. The default is CLASS=LONG. 

LONG 

identifies tasks of long or unpredictable duration; 
typically, these include: 


Tasks involved in conversational activity with a 
terminal operator. 

Large or unknown volume data collection, data 
transmission, or data manipulation type tasks.. 

CICS/VS journal tasks (TRANSID=CSJC). ; For additional 
information, see "Journal Management"tin Chapter 4.6 of 
this manual. - , . 


SHORT 

is used to identify short duration tasks; typically, these 
include: 

Single input/single output inquiry tasks 
(nonconversational terminal activity) 

Small volume data collection tasks. 

Data transmission tasks communicating with high speed 
terminals transmitting small batches of data at a time. 


: ’ f : ’ 
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Small volume data manipulation type tasks. 


Note : In many cases a short duration task may perform better 

if defined to CICS/VS as a long duration task and possibly as 
an anticipatory paging class of task with a predefined number 
of pages. This may be true if the task will use large amounts 
of virtual storage (via GETMAIN/FREEMAIN). The instruction 
path length through the storage control program will be shorter 
for a long running (isolated) task than for a short running 
task, if the short running task causes the storage control to 
go through page acquisition. Also, an anticipatory paging 
class of task will not be dispatched until all the virtual 
storage areas it will reference are in real storage (thus 
minimizing page faulting). 


| COMPAT=NOjFORMAT|FULLBUF 

is used to flag those transactions that are to be run in 2260 
compatibility mode on the 3270 Information Display System. 

Note : 2260 compatibility is not supported for 3270s operating 

through VTAM. In these cases, this operand is ignored. 
COMPAT=NO is the default. 

NO 

indicates that 2260 compatibility is not required. 

FORMAT 

indicates that the transaction is to be run in FORMAT mode. 
FULLBUF 

indicates that the transaction is to be run in FULLBUF 
mode. 

For a discussion of FORMAT and FULLBUF modes of compatibility 
operation, see the section "2260 Compatibility for the 3270" in 
Chapter 5.5 of this manual. 


| DTB=NO|YESJ(YES,NO) 

indicates whether the dynamic transaction backout facility, for 
backing out the effects of a transaction which terminates 
| abnormally, will be required. If this operand is omitted, the 

| DTB option from the DFHPCT TYPE=INITIAL macro is taken. 

| Because a dynamic transaction backout buffer is not acquired 

I until a protected resource is modified, the overheads involved 

j for DTB=YES for a task that never modifies a protected resource 

I are minimal. 

| NO 

j indicates that the dynamic transaction backout facility is 

| not required. 

YES 

indicates that the dynamic transaction backout facility is 
required. 
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(YES,NO) 

indicates, for a transaction running in an intersystem 
communication session, that normal dynamic transaction 
backout facilities will be provided, except when the 
session fails at a critical time during sync point or 
return processing. Refer to the CICS/VS System/Application 
Design Guide for further details on recovery facilities for 
intersystem communication sessions. 


DTIMOUT=NO|numeric-value 

indicates the length of time after which the deadlock timeout 
facility will terminate a suspended task in such cases as a 
short-on-storage condition, a temporary storage SUSPEND, or a 
terminal control ALLOCATE request. The default is no deadlock 
timeout value (DTIMOUT=NO). 

NO 

indicates that the deadlock timeout feature is not 
required. 

numeric value 

specifies the length of time (MMSS for minutes and seconds) 
after which the deadlock timeout facility will terminate a 
suspended task. Note that, if this option is specified, a 
transaction that has SPURGE=NO specified will be terminated 
after the interval specified in the DTIMOUT operand. 


| DUMP=YES|NO 

specifies whether a dump is to be produced if the transaction 
terminates abnormally. The default is DUMP=YES. 


| DVSUPRT=ALL | VTAM | NONV 

identifies transactions that are only permitted to execute on a 
terminal or logical unit supported by a particular access 
method as specified in the associated TCTTE• The default is 
ALL. 

ALL 

indicates that the transaction can execute with any 
terminal or logical unit. 


VTAM 

indicates that the transaction may only execute with 
logical units. 

NONV 

indicates that the transaction may only execute with start- 
stop and BSC terminals. 


| FDUMP=ASRA,ASRB 

indicates whether the formatted dump program is to be invoked 
if the transaction terminates with a program interrupt (ASRA), 
or with an operating system abend (ASRB). If FDUMP= is 
specified, a formatted dump will be taken in addition to a 
transaction dump. This operand defaults to the FDUMP 
specification made in DFHPCT TYPE=INITIAL. If neither operand 
is specified, the formatted dump program will not be invoked. 

ASRA 

indicates that a formatted dump will be taken after a 
program interrupt. 
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ASRB 

indicates that a formatted dump will be taken after an 
operating system abend. 


| INBFMH=NOIALL1 EODS 1 DIP 

applies to transactions running on logical units. By 
generating this parameter the user can specify whether or not a 
function management header (FMH) received from a logical unit 
is to be passed to the application program’s TIOA. 

NO 

indicates that the FMHs are discarded. 

ALL 

indicates that all FMHs are passed to the application 
program. 

EODS 

indicates that an FMH is only passed to the application 
program if it indicates end of data set (EODS). 

DIP 

indicates that the batch data interchange program (DFHDIP) 

| is to process inbound FMHs. BMS will issue a batch data 

j interchange receive request if a BMS receive request has 

j been issued, and a batch data interchange received request 

j is issued instead of a terminal control receive request. 


| JFILEID=NO|SYSTEM|nn 

specifies where records generated during automatic journaling 
are to be stored. The default is NO. 

NO 

indicates that no automatic journaling of messages is to 
take place. 

SYSTEM 

indicates that automatic journaling for logical units is to 
be performed on the system log when this transaction is 
executing. 

nn 

indicates the journal ID to be used for automatic 
journaling. This may be any value from 2 through 99. 

Note : If automatic journaling is specified, the journal 

control program and journal control table parameters must be 
specified to support the TCP automatic journaling requests. 


| LOGREC=NO|YES 

specifies whether the application wants each DFHTC TYPE=READ to 
be satisfied by a logical record. This option allows existing 
2770 and 2780 based application programs to be attached to a 
batch logical unit without modification to the program. The 
default is LOGREC=NO. 


| MSGJRNL=INPUT|OUTPUT 

identifies whether automatic journaling is to be performed when 
the transaction is running on a logical unit. If this operand 
is specified, JFILEID is also required. 
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INPUT 

indicates that journaling is required for input messages. 
OUTPUT 

indicates that journaling is to be performed for output 
messages. 

Either or both INPUT and OUTPUT can be specified. If both are 
specified, they must be in parentheses. 


NEPCLAS=integer 

defines the class of the transaction for the node error program 
module (DFHZNEP). Integer is a value between 0 and 255; note 
that specifying 0, or a value greater than 255, will result in 
a subsequent link to the default transaction class routine (see 
| "User-Written Node Error Programs" in Chapter 4.35. The 

default value is 0.. The identifying integer is placed in the 
PCT for reference by the DFHZNEPI TYPE=ENTRY macro instruction. 


OPTGRP=name 

specifies the name of the particular message option group. The 
message option group is generated by a DFHPCT TYPE=OPTGRP macro 
instruction. If this operand is not specified, no message 
protection options are available to the task. This operand 
applies only to logical units. 


| PRIVATE==NO| YES 

specifies the type of storage area the task is to run in. The 
default is PRIVATE=NO. PRIVATE^YES has the same internal 
effect in CICS/VS as a specification of CLASS=LONG. 

NO 

indicates that this task may run in the same storage area 
as other tasks. 

YES 

indicates that CICS/VS will attempt to isolate the storage 
allocated to the task from other active tasks in the 
system. 

This can be used during a trial period for new transactions 
or as desired by the user. 


RESTART=NO|YES 

indicates whether the transaction restart facility is to be 
used to restart those transactions that terminate abnormally 
and are subsequently backed out by the dynamic transaction 
backout facility (DTB=YES). The transaction restart facility 
is dependent upon DTB=YES having been specified. The default 
is RESTARTING. 


If RESTART=YES is specified, the transaction that failed is 
restarted from the beginning of the transaction. If dynamic 
transaction backout is unable to restart the transaction, or if 
restart is suppressed dynamically, DFHPEP will be invoked in 
the normal way. The transaction restart facility is especially 
useful in such situations as a program isolation deadlock, 
where the transaction can be restarted automatically rather 
than resubmitted manually. 
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i m 

| indicates that the restart facility is not required. 

| YES 

| indicates that the restart facility is to be used. 


| RMTNAME=name 

| indicates the four-character name by which the transaction is 

J known in the remote system in an intersystem communication 

| session. The name by which the transaction is known in the 

| local system is given in the TRANSID operand. Note that the 

j transaction need not necessarily reside on the remote system. 


J RTIMOUT=NO|numeric-value 

is used to specify the timeout value for the read timeout 
feature. The default is no read timeout value (RTIMOUT=NO). 

NO 

indicates that the read timeout feature is not required, 
numeric-value 

specifies an interval (MMSS for minutes and seconds) after 
which the task will be terminated if no input has been 
received from the terminal. The maximum value that can be 
specified is 70 minutes. The value specified in this 
option is rounded up to units of 16.78 seconds. Thus, the 
minimum value (after rounding-up) is 16.78 seconds. If 
this operand is not generated, or if a zero value is 
specified, no read timeout will occur. Instead of 
specifying a numeric parameter, the user may specify a 
symbol previously defined as a numeric value. 


SCRNSZE= DEFAULT |ALTERNATE 

selects the 3270 screen or printer buffer size (defined in the 
DFHTCT TYPE=TERMINAL macro) to be used for this transaction. 

If this operand is not specified, the option indicated in the 
DFHPCT TYPE=INITIAL macro will be used. For further 
information on the choice of screen sizes and buffer sizes, 
refer to the ALTSCRN and DEFSCRN operands in DFHTCT 
TYPE=TERMINAL. 

DEFAULT 

indicates that transactions will be run in default screen 
size mode, using the values from the DEFSCRN operand in 
DFHTCT TYPE=TERMINAL. 

ALTERNATE 

indicates that transactions will be run in alternate screen 
size mode, using the values from the ALTSCRN operand in 
DFHTCT TYPE=TERMINAL. SCRNSZE=ALTERNATE may be used for 
all CICS/VS service transactions (for example, CSMT). 
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Notes: 


1. If DFHPCT TYPE=ENTRY has SCRNSZE=DEFAULT, and if the DFHTCT 
TYPE=TERMINAL macro contains the ALTSCRN or DEFSCRN 
operands, the transaction will be run in default screen 
size mode, using the erase write (EW) command. That is, 
whenever the terminal issues a terminal output request with 
the ERASE option, the 3270 EW command will be inserted in 
the data stream. The screen size specified in the DEFSCRN 
operand will be assumed, and BMS will use the value 
specified in the PGESIZE operand as the page size. 

2. If DFHPCT TYPE=ENTRY has SCRNSZE=ALTERNATE ^nd DFHTCT 
TYPE=TERMINAL has the ALTSCRN operand, the/transaction will 
be run in alternate screen size mode, nsyig the erase write 
alternate (EWA) command. That is, whenever the transaction 
issues a terminal output request with £ne ERASE option, the 
3270 EWA command will be inserted in the data stream. The 
ALTSCRN value will be assumed as the screen size, and BMS 
will use the value in ALTPGE as the page size. 

3. The SCRNSZE option in DFHPCT TYPE=ENTRY will be ignored if 
the DFHTCT T YPE=TERMINAL macro does not contain either 
ALTSCRN or DEFSCRN. The transaction will then operate with 
the screen sizes and page sizes used by an existing 3270- 
based transaction. That is, the screen size will be 
assumed from the related TRMMODL operand in DFHTCT 

TYPE—TERMINAL, the page size will be taken from PGESIZE, 
and the ALTPGE value will be ignored. The 3270 EW command 
will be inserted for output requests with the ERASE option. 


| SPURGE=NOjYES 

is used to set the system stall purge indicator. The default 
is SPURGE=NO. 

NO 

indicates that the transaction is not purgeable when a 
system stall condition is detected. 


YES 

indicates that the transaction is purgeable in a stall 
condition. 


SYSIDNT=name 

specifies the one- to four-character name of the system that 
this PCT entry points to and must be specified in an 
intersystem communication session. The name provided must be 
the same as that in the SYSIDNT operand DFHTCT TYPE=ISLINK 
unless it is specified in an explicit remote request in an 
application program. 


| TCLASS=class|NO 

specifies whether a task is to have an associated class. The 
default is TCLASS=NO. 

task class 

indicates a value (from decimal 1 to 10) of the class 
associated with a task. 

NO 

indicates that no class is assigned to the task. 
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Notes The TCLASS parameter cannot be used to specify a task 
class for CICS/VS-supplied transactions or transactions that 
have an identification starting with "C w . 

TCLASS should not be specified for many CICS/VS-supplied 
transactions (for example, CSMT, CSTE, CSTA) because their 
initiation could be inhibited if the class threshold was 
reached. 


| TIOTYPE=DELAY|IMMED 

specifies the type of logical unit I/O processing to be 
performed for the transaction. This operand applies to VTAM- 
supported TCTTEs only. The default is DELAY. 


DELAY 

specifies that a task's request for I/O service (without an 
accompanying WAIT request) is performed when the task 
enters a CICS/VS WAIT state or terminates. 

IMMED 

specifies that a task's request for I/O service is 
initiated immediately without an accompanying WAIT request 
being necessary. If the PROTECT option is specified in a 
DFHPCT TYPE=OPTGRP macro instruction associated with this 
PCT entry, it overrides the TIOTYPE=IMMED specification for 
output operations. 


| TPURGE=NO j YES 

is used to set the terminal error purge indicator. The default 
is TPURGE=NO. 

NO 

indicates that the transaction may not be purged when a 
terminal error occurs. 

YES 

indicates that the transaction may be purged when a 
terminal error occurs. 


TRANSEC=decimal-value 

is a one- to three-digit decimal value with a range of 1 
through 24 used to define the transaction security associated 
with each terminal operator. The default is TRANSEC=1. 

A master terminal operator may be designated in CICS/VS by 
specifying the following options; 

• DFHPCT TYPE=ENTRY,TRANSID=CSMT,TRANSEC=decimal value 

• DFHSNT TYPE=ENTRY,SCTYKEY=same decimal value as in TRANSEC 
parameter 

These entries indicate that the transaction identifier (CSMT) 
for the master terminal transaction can only be issued by the 
operator whose security key value at sign-on matches the 
transaction security key given to the master terminal 
transaction. 

Note : When a task is automatically initiated (through 
transient data or interval control), the operator signed on to 
the terminal must have a security code equal to the transaction 
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initiated. To ensure that all automatically initiated tasks 
can be initiated without a security violation, either the 
security code of the transaction should be "1" or the operator 
signed on the terminal should have a maximum security key prior 
to the automatic initiation of a task. 

In the case of a no-operator terminal, such as a 3284 printer, 
the operator security code defaults to "1"? therefore, any task 
associated with this type of terminal which is to be initiated 
automatically must have a security code of "1". 


TRNPRTY=decimal-value 

is used to define the transaction priority. This one- to 
three-digit decimal value from 0 to 255 is used in establishing 
the overall transaction processing priority. (Transaction 
processing priority is equal to the sum of the terminal 
priority, transaction priority, and operator priority, not to 
exceed 255.) The default is TRNPRTY=1. 


| TRNSTAT -ENABLED iDISABLED 

indicates the transaction status. The default is 
TRNSTAT=ENABLED. 

ENABLED 

allows transactions to be attached normally. 

DISABLED 

indicates that attempts to attach this task will not be 
allowed. 


TWASIZE=decimal-value 

is a one- to five-digit decimal value which determines the size 
(in bytes) of the transaction work area to be acquired for this 
transaction. The default is TWASIZE^O for user-supplied 
transactions. The requirements of the transactions that are 
supplied by CICS/VS vary, but the minimum TWASIZE required is 
generated, by default, during the expansion of the macro. The 
maximum size is 32767 minus the length of the task control area 
(TCA). 


XTRANID=hexadecimal-transaction-identifier 

specifies a 4-byte transaction identifier specified in 
hexadecimal notation (the identifier therefore comprises up to 
eight hexaedcimal digits). If less than eigth hexadecimal 
digits are specified, the identifier will be padded on the 
right with blanks. XTRANID must not begin with X , C3* or end 
with X B FFFFFF # • XTRANID provides an alias transaction 
identifier for that specified in the TRANSID and TASKREQ 
operands, and may be used for terminals that use characters 
that are not in the assembler set. If XTRANID is specified, 
INDEX=YES must be specified in DFHPCT TYPE=INITIAL. 


For OS/VS only 


PRMSIZE=number 

defines the primed storage allocation size. The value 
specified must not exceed 65520 bytes and must include an 
| allowance for the primed allocation area (PRA) header, the TCA, 
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the TWA, and the LIFO storage used by CICS/VS nucleus modules. 
Roughly 1000 bytes should be allowed in total for the PRA r the 
TCA, and LIFO storage. 

Primed storage retains storage used by a task which has 
completed, and holds it for later use as an initial allocation 
for another task of the same transaction identification. 

Note : PRMSIZE=nn and ANTICPG=YES or nn cannot be specified for 

the same transaction. Furthermore, primed storage allocation 
may not be specified for a long-running task (CLASS=LONG). If 
primed storage allocation is specified, the task class will be 
changed to short. 


| REQUIRED ENTRIES — DFHPCT TYPE=GROUP 

I 

| The optional DFHPCT TYPE=GROUP macro instruction allows the system 
j programmer to specify the transaction identifications, which are 
| required when certain CICS/VS facilities are used, on a functional basis 
j instead of having to specify the TRANSID=xxxx operands for each 
| individual feature being generated in the system. This simplifies the 
| task of specifying the required entries for the CICS/VS-supplied 
j transaction names. For example, DFHPCT TYPE=GROUP,FN=ATP provides the 
| required entries previously supplied by specifying: 

| • DFHPCT TYPE=ENTRY,TRANSID=CAQP 
j • DFHPCT TYPE=ENTRY,TRANSID=CATP 
| • DFHPCT TYPE=ENTRY,TRANSID=CRDR 

| • DFHPCT TYPE=ENTRY,TRANSID=CWTR. 

I 

| The user should refer to the PCT section of Appendix A for more 
| detailed information on the required entries. Pre-defined entries in a 
| GROUP macro (for example, security codes) may be overridden in a DFHPCT 
j TYPE=ENTRY macro coded before the GROUP macro. Otherwise, GROUP and 
| ENTRY macros can be mixed in any order. The "groupable" entries will 
j not be generated twice in an assembly. 

r r r - - 

| |DFHPCT j TYPE=GROUP | 

| | | ,FN=(function[,...1-) | 

( l -t-- l -j 

I 

J TYPE=GROUP 

j indicates that required entries in the PCT will be generated 

j automatically on a functional basis. 


FN=function 

indicates the generic function name that generates the entries 
required in the PCT for the associated facility. Any number of 
options from the list below can be specified in one DFHPCT 
TYPE=GROUP macro. The options are: 

STANDARD 

provides the transaction identifications that are required 
in the majority of CICS/VS systems. The transaction 
identifications generated are: 


• CSTT - supervisor statistics program 

• CSAC - abnormal condition program 

• CSTE - terminal abnormal condition program 
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AKP 


generates TRANSID=CSKP for the activity keypoint program. 


ATP 

provides the transaction identifications associated with 
the asynchronous transaction processing facility. The 
transaction identifications generated are: 

• CAQP - asynchronous purge queue 

• CATP - asynchronous transaction control program 

• CRDR - ATP input processor 

• CWTR - ATP output processor 


AUTOSTAT 

generates TRANSID=CAUT for the automatic statistics 
summarization utility. 


BMS 

generates the following identifications for transactions 
running under BMS: 


• CSPG - terminal page retrieval 

• CSPQ - terminal page clean-up 

• CSPS - delayed message delivery 


CONSOLE 

generates TRANSID=CWTO for processing unit console support 
in CICS/DOS/VS. 


FE 

generates TRANSID=C SFE for the FE terminal test facility. 


HARDCOPY 

generates TRANSID=CSPP for the 3270 print support function 
(BTAM and VTAM). 


ISC 

generates the following transaction identications for 
intersystem communication support and DL/I shared data base 
support in CICS/OS/VS: 


• CSMI - mirror transaction 

• CSNC - DL/I inter-region new connection transaction 


JOURNAL 

generates TRANSID=CSJC for the journal tasks bootstrap 
program, and is required if journal management is being 
used. 

MASTTERM 

provides the following transaction identifications for the 
master terminal facility: 


• CSMT - master terminal functions 

• CSST - supervisor terminal functions 

• CSOT - terminal operator functions 
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MSWITCH 

generates TRANSID=CMSG for the message switching program. 
Note that the user may choose any four-character code to 
replace CMSG. 

NUMERICS 

generates TRANSID=8888 and 9999 for numeric-only devices, 
such as the 7770, as the sign-off and sign-on transaction 
identifications. 

RESEND 

generates TRANSID=CSRS for the resend program (VTAM only). 
RESPLOG 

generates TRANSID=CSLG for the response logging program 
(VTAM only). 

SIGNON 

generates the transaction identifications associated with 
the sign-on program. The transaction identifications 
generated are: 


• CSSN - sign-on 

• CSSF - sign-off 


TIME 

generates TRANSID=CSTA for the time-of-day adjustment 
program. 

VTAM 

generates TRANSID=CSNE for the VTAM node abnormal condition 
program and CSGM for the good morning sign-on message, 

VTAMPRT 

provides the following transaction identifications 
associated with the VTAM 3270 print function: CSCY, CSPK, 
and CSRK. 


TRANSACTION DESCRIPTION OPTIONS — DFHPCT TYPE=OPTGRP 


The DFHPCT TYPE-OPTGRP macro instruction is used to control message 
protection processing for a task executing on a VTAM-supported TCTTE. 

The parameters specified cause CICS/VS to log relevant data about the 
transactions terminal data during processing, and are also used for 
message resynchronization if a failure occurs. 

| DFHPCT TYPE=OPTGRP macros must precede the DFHPCT TYPE=ENTRY macros that 
| relate to them. 

r r r i 

I name jDFHPCTj TYPE=OPTGRP | 

| | | (,MSGPOPT=(PROTECT,MSGINTEG,ONEWTE,CCONTRL)1 j 

| | j [,MSGPREQ=(PROTECT,MSGINTEG,ONEWTE,CCONTRL)] | 

L-L-t- i 


name 

specifies the name of the message option group. This operand 
is required and may be any valid assembler-language name, from 
one to six characters. This is the same name that is specified 
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in the OPTGRP=name parameter of the DFHPCT TYPE=ENTRY macro 
instruction. 


TYPE=OPTGRP 

generates a transaction option group macro. 


| MSGPOPT=option 

specifies which options the task can use. For tasks using 3600 
logical units, MSGPREQ and MSGPOPT provide the same function; 
that is, any option (whether specified by MSGPREQ or MSGPOPT) 
can be invoked by the task. 


| MSGPREQ=option 

defines the processing options and characteristics required to 
run a task. 

PROTECT 

specifies a protected task. This option provides message 
integrity (see the MSGINTEG option). It also causes 
message logging to take place. Also, CICS/VS will record 
the contents of deferred write requests that are pending at 
a sync point, and record the receipt of the definite 
response associated with the deferred write on the system 
log for message recovery and resynchronization purposes. 
Journaling support is required during generation of the 
CICS/VS system. The PROTECT option must not be specified 
for a PIPELINE transaction. 

MSGINTEG 

specifies that a definite response is to be requested with 
an output request to a logical unit communicating with this 
task. This option must not be specified for a PIPELINE 
transaction. (See DFHTCT TYPE=TERMINAL later in this 
chapter.) 


ONEWTE 

specifies that the transaction is only permitted one DFHTC 
TYPE=WRITE during its execution. Any additional write 
requests are treated as errors, and the task is readied for 
abnormal termination. BRACKET=YES must be specified in the 
DFHTCT TYPE=TERMINAL macro for logical units. The ONEWTE 
option must be specified for a PIPELINE transaction. 

CCONTRL 

specifies that the application program may control the 
outbound chaining of request units. If this option is 
specified, the PROTECT option must not be specified. Also, 
if CCONTRL is specified, ONEWTE means one chain, and not 
| one terminal control output request. 
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END OF PROGRAM CONTROL TABLE 


DFHPCT TYPE=FINAL 


The end of the program control table is indicated by the DFHPCT 
TYPE=FINAL macro instruction, which is the last statement in the 
assembly of the program control table before the assembler END 
statement. This macro instruction creates a dummy entry to signal the 
end of the table. 


| DFHPCT | TYPE=FINAL 


TYPE=FINAL 

indicates the end of the program control table. 


EXAMPLES 


| Figure 3.2-10 illustrates the coding that is required to create a 
program control table. The transactions include: 

• Three transactions of a higher priority than the default priority 
(TRNPRTY=1 is the default) 

• Two transactions with security Key protection 

• Total of nine transactions 

| Refer to the FN= STANDARD option of the DFHPCT TYPE=GROUP macro for a 
I list of all the entries required when creating a program control table. 
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DFHPCT TYPE=INITIAL 

DFHPCT TYPE=ENTRY, * 

TRANSID=C0B1, * 

TWASIZE=64, * 

PROGRAM= COBPGM1 

DFHPCT TYPE=ENTRY, * 

TRANSID=COB2, * 

TRNPRTY=100, * 

TRANSEC=10, * 

PROGRAM=COBPGM2 

DFHPCT TYPE=ENTRY, * 

TRANSID=COB3, * 

TWASIZE=100, * 

TRANSEC=5, * 

PROGRAM=COBPGM3, * 

TPURGE=YES 

DFHPCT TYPE=ENTRY, * 

TRANSID=COB4, * 

PROGRAM=COBPGM4, * 

RTIMOUT=5 010, * 

TPURGE=YES 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSAC, * 

TRNPRTY=5, * 

TWASIZE=40, * 

PROGRAM=DFHACP 

DFHPCT TYPE= ENTRY, * 

TRANSID=CSMT, * 

TWASIZE=160, * 

PROGRAM=DFHMTPA 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSST, * 

TWASIZE=100, * 

PROGRAM=DFHMTPA 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSTA, * 

TWASIZE=000, * 

PROGRAM=DFHTAJP 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSSN, * 

TRNPRTY=99, * 

TWASIZE=000, * 

PROGRAM=DFHSNP, * 

SPURGE=YES 

DFHPCT TYPE=FINAL 
| END 

| Figure 3.2-10 (Part 1 of 23. Program Control Table - Example 1 
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DFHPCT TYPE*INITIAL 

GR0UP1 DFHPCT TYPE=OPTGRP, * 

MSGRREQ=ONEWTE 

GROUP2 DFHPCT TYPE^OPTGRP, * 

MSGPREQ 3 (ONEWTE,MSGINTEG) 

GROUP3 DFHPCT TYPE 3 OPTGRP, * 

MSGPOPT=PROTECT 

DFHPCT TYPE 3 ENTRY, * 

TRANSID=TRNA, * 

PROGRAM 3 PROGRA, * 

DVSUPPT=NONV 

DFHPCT TYPE 3 ENTRY, * 

TRANSID=TRNB, * 

PROGRAM=PROGB, * 

PRMSIZE=1000, * 

DV SUPRT= VTAM, * 

OPTGRP=GROUP2 

DFHPCT TYPE* 5 ENTRY, * 

TRANSID=TRNC, * 

PROGRAM 3 PROGC, * 

OPTGRP=GROUPl 

DFHPCT TYPE=ENTRY, * 

TRANSID=TRND, * 

PROGRAM=PROGD, * 

OPTGRP=GROUP3 

DFHPCT TYPE 3 ENTRY, * 

TRANSID=CSSN, * 

TRNPRTY=99, * 

TWASIZE=0 00, * 

PROGRAM 3 DFHSNP, * 

SPURGE=YES 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSLG, * 

TWASIZE=0, * 

PROGRAM=DFHZRLG 

DFHPCT TYPE=GROUP, * 

| FN 3 STANDARD, * 

DFHPCT TYPE*FINAL 
| END ,/■ 


| Figure 3.2-10 (Part 2 of 2). Program Control Table - Example 2 



The program list^jt&ble is a list of a logically related group of 
programs. One use of a PLT is to define a list of programs to be 
executed prior to the terminal control program receiving control after 
system initialization processing, or a list of programs to be executed 
during system termination. There must be an entry in the processing 
program table (ppf) for each program to be used. 

Another use the PLT is to define a logically related group of 
programs to be <Jishhled or enabled through the master terminal. The 
tables are differentiated by means of the suffix parameter. 

When writing PLT programs, the following factors concerning PLT 
programs executed! during system initialization should be considered: 

• The programs cannot communicate with terminals, because the TCA of 
the terminal^fepntrol program is used during execution of all PLT 
programs.; 
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• The programs should not request any service that could logically 
suspend the task. Suspending the TCA of the terminal control 
program will cause the system to be terminated abnormally. Post¬ 
initialization phase programs must not depend on transactions being 
initiated by interval control, because there is a possibility that 
programs generated in a warm start may depend on the post¬ 
initialization phase being complete. 

• The program should never change the priority of the task executing 
the PLT program, because the task is TCP and it must remain as the 
highest priority task. Even if "chapped" to itself (X'FF'), it 
could cause itself to become lower in priority than other X'FF' 
priority tasks already attached. 

• Although attaching of other tasks during PLT processing is 
supported, they must not access a protected resource that is also 
being accessed by the TCP task that is executing PLT programs. 

Task control ENQ/DEQ facilities can be used in the PLT programs 
executed by the TCP task and other programs executed by the 
attached programs to ensure single threading of the use of 
protected resources. However, it is the user's responsibility to 
ensure that the TCP task always enqueues first. (If it attempts an 
ENQ and fails to gain control of the resource, it will be suspended 
and cause CICS/VS to abend.) Because concurrent accessing of 
protected resources is difficult to control, it is recommended that 
the resources be serialized, and that no task is attached to access 
the resource until the TCP task executing the PLT program has 
completed its processing. 

• Because standard CICS/VS services are available to PLT programs, it 
is important to understand and consider the effect of these 
services when they involve accessing protected resources as defined 
to CICS/VS. When a protected resource is accessed, CICS/VS 
normally enqueues on the resource to ensure exclusive ownership, 
during the task's use of the resource. The actual dequeuing of a 
protected resource is deferred until the task terminates or 
voluntarily declares itself to be at a "sync" point (through the 
DFHSP TYPE=USER macro instruction). PLT programs that are involved 
in rebuilding a protected file control data base will cause an 
enqueue to occur for each logical record they access. Because the 
dequeues are deferred, it is advisable for the user to declare 
"sync" points throughout the recovery process to allow dequeues to 
occur. If this procedure is not followed, dynamic storage can 
become filled with CICS/VS control blocks used to control the 
enqueue/dequeue facility. In addition, no other task should be 
attached that could also access records in the data base until 
after the PLT program has completed its entire rebuilding 
operation. Enqueuing on the data base by both tasks will not keep 
the attached task from gaining control of the data base when the 
PLT processing task declares a "sync" point. This is because of 
the implicit dequeuing that occurs at that time. 

The termination programs defined in DFHPLTxx operate in one of two 
time-dependent environments: the first quiesce stage and the second 
quiesce stage. During the first stage, the programs defined to run in 
that stage execute. Terminals are still available, but only those 
transactions defined in the transaction list table may be initiated from 
them. Existing tasks, automatically-initiated tasks, or ATP batches in 
process are allowed to continue to their normal conclusion. The second 
quiesce stage begins at the point in the program list table defined by 
DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM. Termination activity waits until 
all first quiesce stage system activity stops. Termination then 
continues with the TCP and task control ATTACH disabled, and, when all 
DFHPLT programs defined to execute in the second quiesce stage have been 
completed, CICS/VS terminates further execution. 
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CONTROL SECTION 


DFHPLT TYPE=INITIAL 


The DFHPLT TYPE=INITIAL macro instruction generates the program list 
table control section. 


r-r-r- 

j jDFHPLT j TYPE=INITIAL 

| | | I , SUFFIX=xxl 


1 

I 

I 


_J 


TYPE=INITIAL 

establishes the control section into which the program list 
table is assembled. 


SUFFIX—xx 

is a one- or two-character alphameric suffix for the program 
list table being assembled. This suffix, if present, is 
appended to the standard module name (DFHPLT) which is used to 
name the module on the linkage editor output library. 


ENTRIES IN PROGRAM LIST TABLE — DFHPLT TYPE=ENTRY 


| Entries are specified in the program list table as follows. Note that 
j an entry for each program list table generated must be included in the 
j processing program table (DFHPPT). 


\ IDFHPLT \ TYPE=ENTRY ] 
j j | ,PROGRAM=(program t,program,...]) j 
l-1_l_„_J 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 


PROGRAM=program name 

specifies a program name of up to eight characters. An entry 
in the PPT is required for each program named. 


r - r - r ---- 

j IDFHPLT | TYPE=ENTRY 

| | j,PROGRAM=DFHDELIM 

t-1-c-- 


j 
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PROGRAM=DFHDELIM 

is used with programs to be executed during system termination. 
Following the specification of any programs which are to be 
executed during the first quiesce stage, the DFHPLT TYPE=ENTRY, 
PROGRAM=DFHDELIM entry delimits the first quiesce stage 
programs in the table. The specification of any programs to be 
executed during the second quiesce stage follows this entry. 
Note that the second stage programs are not allowed to use any 
terminal control services or task control ATTACH. No 
automatically-initiated transaction can be initiated during the 
second quiesce stage. 


r-r-r- 

| |DFHPLT j TYPE=ENTRY 

| | j ,PROGRAM=DLZSTPOO 

L-L-L-- 


(CICS/DOS/VS only) ] 


J 


PROGRAM=DLZSTPO0 

is used to quiesce the DL/I DOS/VS online system. Upon 
receiving control, this program verifies that there are no 
active DL/I tasks, and then closes the DL/I data base log and 
DL/I data bases. After execution of this program all requests 
for DL/I services are ignored. 


END OF PROGRAM LIST TABLE — DFHPLT TYPE=FINAL 


The DFHPLT TYPE=FINAL macro instruction specifies the end of the program 
list table. The assembler END statement must follow. 

\ fDFHPLT \ TYPE=FINAL ] 

L-L-L_J 


TYPE=FINAL 

indicates the end of the program list table. 


EXAMPLE 


| Figure 3.2-11 illustrates the coding required to generate a program list 
table. 
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DFHPLT TYPE=INITIAL, LIST OF PROGRAMS TO BE * 

SUFFIX=TM EXECUTED SEQUENTIALLY 

DURING SYSTEM TERMINATION 
EXECUTED DURING 1st QUIESCE PHASE: 
DFHPLT TYPE=ENTRY,PROGRAM=TRARA (PROGRAMS MUST ALSO BE 
DFHPLT TYPE=ENTRY,PROGRAM=TRARB ENTERED IN THE PPT) 

DFHPLT TYPE=ENTRY,PROGRAM=TRARC 

DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM 

EXECUTED DURING SECOND 
QUIESCE PHASE: 

DFHPLT TYPE=ENTRY,PROGRAM=TRAFA 
DFHPLT TYPE=ENTRY , PROGRAM=TRAFB 
DFHPLT TYPE=FINAL 

DFHPLT TYPE=INITIAL, 

SUFFIX=IN 

* 

DFHPLT TYPE=ENTRY,PROGRAM=TRASA 
DFHPLT TYPE=ENTRY,PROGRAM-TRASB 
DFHPLT TYPE=ENTRY,PROGRAM=TRASC 
DFHPLT TYPE=FINAL 
| END 

| Figure 3.2-11. Program List Table - Example 


PPT — PROCESSING PROGRAM TABLE 


The processing program table allows the user to describe to program 
control the control information concerning all processing programs. In 
addition, program control uses portions of each table entry to retain 
certain information for maintaining control of the user*s programs and 
to capture specified program statistics. 

This table is required by CICS/VS to verify the processing program 
identification, to keep count of the number of tasks using that program, 
to maintain the address of the processing program, to maintain the 
direct access address and size of the program, and to maintain 
statistics on the processing program. 

Those programs most often used during execution of CICS/VS should be 
specified first during preparation of the processing program table. 


LIST OF PROGRAMS TO BE * 

EXECUTED SEQUENTIALLY 
DURING SYSTEM INITIALIZATION 
(PROGRAMS MUST ALSO BE 
ENTERED IN THE PPT) 


♦ 

♦ 


* 

♦ 

* 


CONTROL SECTION — DFHPPT TYPE=INITIAL 


The control section into which the processing program table is assembled 
is established by the DFHPPT TYPE=INITIAL macro instruction, which must 
be coded as the first statement in the source deck used to assemble the 
processing program table. 


| |DFHPPT | TYPE=INITIAL 

|| | | [,INDEX—{NO|YES} 1 

! | | C,SUFFIX=xx] 


I 

I 

I 

.J 
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TYPE=INITIAL 

establishes the control section into which the processing 
program table is assembled. 


| INDEX=NO|YES 

j specifies whether indexing is to be used. The default is NO. 

| In some circumstances, indexing reduces the processor cycles 

required to search CICS/VS tables by shortening the scan to 
locate entries. It also reduces the CICS/VS working set for 
large tables by reducing references to little-used or unused 
| pages. This operand should not be used unless the PPT is 

longer than 6K bytes. Refer to the appropriate CICS/VS System 
Programmer's Guide for a discussion on performance 
| considerations involving indexing. 


I 

I 

I 

I 


YES 

indicates that indexing will be used. When this option is 
specified, an alphabetically ordered list of transaction 
names is generated as part of the expansion of the DFHPPT 
TYPE=FINAL macro. 


I 


NO 

indicates that indexing will not be used. 


| Note : Page-indexing (the former PAGENXD operand) is no longer 

| supported. However, if PAGENXD=YES is specified and the INDEX 

j option does not appear, the entries will be treated as if 

J INDEX=YES were specified. 


SUFFIX=xx 

specifies a one- or two-character alphameric suffix for the 
processing program table being assembled. This suffix, if 
specified, is appended to the standard module name (DFHPPT) and 
is used to name the module on the linkage editor output 
library. If this operand is omitted, a suffix is not provided. 


PROCESSING PROGRAMS — DFHPPT TYPE=ENTRY 


A specific processing program is described to CICS/VS program management 
services by the DFHPPT TYPE=ENTRY macro instruction. Included is 
information on the program name and the type of program. 


| |DFHPPT | TYPE=ENTRY | 

j | j ,PROGRAM=name | 

|| | | [.PGMLANG-( ASSEMBLER !COBOL!PL/IIRPG)] j 

| | | (.PGMSTAT={ ENABLED I DISABLED!] j 

j j | f,RELOAD=(NO| YES)] j 

| j j (,RES=(NO|YES|FIX|ALIGN|PGOOTl1 | 

j | j I,USAGE=MAP) | 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 


Chapter 3.2. DFHPPT TYPE=ENTRY 


187 






PROGRAM=name 

specifies the program identification, up to eight characters in 
length. The indicated program should be link-edited before 
this table is used. 

Note ; For a BMS device-dependent mapset, the program name must 
be derived by appending the mapset suffix to the original one- 
| to seven-character mapset name. The suffix depends on the 

j parameter specified in the TERM operand of the DFHMSD macro 

| instruction that defined the mapset. For further information 

| on mapset suffixes, refer to the CICS/VS Application 

I Programmer's Reference Manual (Macro Level) . 


PGMLANG=language 

specifies the program language. The default is 
PGMLANG=ASSEMBLER. 

ASSEMBLER 

indicates an assembler-language program 
COBOL 

indicates an ANS COBOL program 

PL/1 

indicates a PL/I program. This option may also be written 
as PLI, PL/1, or PL1. 

| RPG 

j indicates an RPG II program (CICS/DOS/VS only). RELOAD=YES 

j must also be specified. 

This parameter must be omitted when preparing PPT entries for BMS maps. 

| PGMSTAT=ENABLED|DISABLED 

specifies the program status. The default is PGMSTAT=ENABLED. 
ENABLED 

indicates that this program may be used in a normal manner. 
DISABLED 

indicates that usage of this program will not be allowed. 


| RELOAD=NO|YES 

specifies whether a load request brings in a fresh copy of a 
program. The default is RELOAD=NO. 


indicates that a load request is ignored if the program is 
currently in storage. 
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I 

I 

I 


I 

I 

I 

I 


I 

I 


I 

I 


YES 

indicates that a fresh copy of the program is to be loaded 
by the program control program each time a load request for 
that program is issued. For RPG II programs, RELOAD=YES 
must be specified. However, the storage is freed 
automatically by CICS/VS. For non-RPG II programs, a 
storage control FREEMAIN, rather than a program control 
DELETE, must be used to free the storage. This parameter 
should not be specified for any program to be executed 
unless some means is devised to issue a FREEMAIN after the 
program is executed. If the FREEMAIN is not issued, the 
CICS/VS dynamic storage area may fill up with copies of the 
program. 

Notes : 

1. When a program is specified with RELOAD=YES and when a 
storage control FREEMAIN is issued, the system programmer 
should subtract 8 bytes from the address at which the 
program is loaded. 

2. RELOAD=YES can be used to load tables or control blocks 
which are modified by execution of the associated 
program(s). It must not be specified for a program which 
is the first program loaded for a task, because the task 
would have no way of issuing a FREEMAIN unless it is for an 
RPG II program CDOS/VS only). 

3. If the dynamic open/close program is to be used, RELOAD=YES 
must be specified in each PPT entry which defines a 
nonresident data set control block. In this case, CICS/VS 
assumes responsibility for releasing the storage occupied 
by nonresident data set control blocks as they are used. 

4. RELOAD=YES must be specified for application programs 
written in RPG II. 

5. RELOAD=YES must also be specified for all CICS/DOS/VS 
transient logic modules. The dynamic open/close program 
maintains a use count for the logic modules to ensure that 
only one copy is in storage at any one time. If the logic 
module is resident in the destination control table, no 
entry is necessary in the PPT. 


| RES=NO|YES|FIX|ALIGN|PGOUT 

specifies the residence status of the program. The default is 
RES=NO. 

NO 

means that the program is not to be permanently resident. 

YES 

means that the program is to be loaded at initialization 
time and is to be permanently resident, but is to be 
pageable by the operating system. Programs specified as 
RES=YES are packed together in the order of the entries in 
the PPT, unless they are also specified in the application 
load table. The order of programs specified in DFHALT 
takes precedence over that in the PPT, and is the 
recommended method of specifying the load order. 


Chapter 3.2. 


DFHPPT TYPE=ENTRY 


189 



FIX 


means the same as RES=YES, except that the pages containing 
all RES=FIX programs are permanently fixed and are not 
pageable by the operating system. This option requires the 
CICSSVC operand to be specified in the DFHSG TYPE=INITIAL 
macro. 

ALIGN 

means the same as RES=YES, except that the program will be 
aligned on a page boundary. ADRSPCE=HIGH (DOS/VS only) in 
DFHALT TYPE=ENTRY causes the end of the program to be page- 
aligned. 

PGOUT 

specifies that the program is permanently resident and 
aligned on a page boundary at initialization time (that is, 
as if RES-ALIGN was specified.) This option is especially 
useful for installations which use a large number of 
programs infrequently. It is, however, inappropriate for 
programs which are heavily used and so would always be 
using real storage. 

In addition, CICS/VS participates in the operating system 
page management by issuing a "force pageout" command when 
the program is no longer in use or will not be needed for a 
relatively long time. The effect is to minimize paging by 
ensuring that the operating system pages out infrequently 
used pages in preference to those that are used frequently. 
The pageout command is issued by CICS/VS to include the 
complete page(s) occupied or partially occupied by the 
program. When the program is next needed, CICS/VS uses an 
operating system macro to force the page containing the 
program*s entry point back into real storage. The page-in 
operation proceeds asynchronously (that is, other CICS/VS 
transactions using different application programs can run 
while the program is being paged in). 

Note s This means that other program(s) or maps occupying 
contiguous space at the bottom of the last page will also 
be included in the pageout list. Therefore, it is a user 
responsibility to package application programs and maps 
correctly to achieve a performance improvement from the use 
of this facility. 

For example, a proper way to package a program which uses 
two BMS maps would be as follows: 

Define the program as RES=PGOUT to page align the 
program and to request pageout. 

Package the two maps contiguously to the program in the 
last page occupied by the program. 

Define the next program in the table as RES=ALIGN or 
RES=PGOUT so that it does not reside in the same page 
as the pageout program. 

The result of this type of packaging will be that when the 
program completes its execution, CICS/VS will issue a 
pageout command to include the address space used by the 
program and by its maps, and not to include the next 
program defined in the processing program table. 

PGOUT is only available with DOS/VS, 0S/VS1 Release 6, and 
OS/VS2 Release 2 and later (MVS). 
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USAGE=MAP 


specifies that the entry describes a BMS map. When USAGE=MAP 
is specified, the map (or assembler-language program) is loaded 
by program control into MAP storage. If the use count for that 
map or program becomes zero, the MAP storage area is released. 
When USAGE=MAP is not specified, the map (or program) is loaded 
into PROGRAM storage. If the use count for that map or program 
becomes zero, the PROGRAM storage is not released until it 
becomes necessary to release the storage cushion. Prior to 
releasing the storage cushion, CICS/VS storage management 
releases any PROGRAM storage areas with a use count of zero. 

USAGE=MAP should be specified for maps (or programs) which are 
infrequently referenced. 


REQUIRED ENTRIES — DFHPPT TYPE=GROUP 


The optional DFHPPT TYPE=GROUP macro instruction allows the system 
programmer to specify the application program names, that are required 
when certain CICS/VS facilities are used, on a functional basis instead 
of having to specify the PROGRAM=name operands for each individual 
program being generated in the system. For example, DFHPPT 
TYPE=GROUP,FN=ATP provides the required programs previously supplied by 
specifying: 

DFHPPT TYPE=ENTRY,PROGRAM=DFHAQP 
DFHPPT TYPE=ENTRY,PROGRAM=DFHATP 
DFHPPT TYPE=ENTRY,PROGRAM=DFHRD1 
DFHPPT TYPE=ENTRY,PR0GRAM=DFHRD2 
DFHPPT TYPE=ENTRY,PROGRAM=DFHWTl, 
and DFHPPT TYPE=ENTRY,PR0GRAM=DFHWT2. 

The user should refer to the PPT section of Appendix A for more 
detailed information on the required entries. Pre-defined entries in a 
TYPE=GROUP macro may be overridden in a DFHPPT TYPE=ENTRY macro coded 
before the TYPE=GROUP macro. Otherwise, TYPE=GROUP and TYPE=ENTRY 
macros can be mixed in any order. The "groupable" entries will not be 
generated twice in an assembly. 


r r r 

j jDFHPPT j TYPE=GROUP 

j j j ,FN=(function(,...],...) 

i-1- l- 


I 

I 


J 


TYPE—GROUP 

indicates that required entries in the PPT will be generated 
automatically on a functional basis. 


FN=function 

indicates the generic function name that generates the entries 
required in the PPT for the associated facility. Any number of 
options from the list below can be specified in one DFHPPT 
TYPE=GROUP macro. The options are: 


Chapter 3.2. DFHPPT TYPE=GROUP 


191 






STANDARD 

provides the application program names that are required in 
the majority of CICS/VS systems. The program names 
generated ares 


• DFHACP 

• DFHSTP 

• DFHSTLK 

• DFHSTKC 

• DFHSTPD 

• DFHSTTD 

• DFHSTTR 

• DFHTACP 

• DFHTEP 


abnormal condition program 
system termination program 

intersystem communication link statistics program 

supervisor statistics program 

Transaction, program, and dump 

statistics program 

data management statistics program 

file and terminal statistics program 

terminal abnormal condition program 

terminal error program 


The programs generated by FN= STANDARD are low-usage 
programs and should be generated towards the end of the 
PPT. 


AKP 

generates PROGRAM=AKP for the activity keypoint function. 

ATP 

provides the program names associated with the asynchronous 
transaction processing facility. The program names 
generated are: 


• DFHAQP - asynchronous purge queue program 

• DFHATP - asynchronous transaction control program 

• DFHRD1 and DFHRD2 - ATP input processor programs 

• DFHWT1 and DFHWT2 - ATP output processor programs 


AUTOSTAT 

generates PROGRAM=DFHSTSP for the automatic statistics 
summarization program. 

BACKOUT 

generates PROGRAM=DFHDBP for the dynamic transaction 
backout program. The pregenerated version (DFHDBP1$) will 
always be generated. 


BMS 

generates PROGRAM=DFHTPQ, DFHTPR, and DFHTPS for BMS. 
CONSOLE 

generates PROGRAM= DFHCWTO for processing unit console 
support in CICS/DOS/VS. 


EDF 

generates the following program names associated with the 
execution (command level) diagnostic facility: 


• DFHEDFP 

• DFHEDFX 

• DFHEDFD 

• DFHEDFM 

• DFHEDFF 

• DFHEDFR 


EDF control program 
EDF task switch program 
EDF display program 
EDF map set 

EDF function description table 
EDF response table 
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FE 

generates PROGRAM=DFHFEP for the terminal test facility. 
HARDCOPY 

generates PROGRAM=DFHP3270 for the 3270 print allocation 
program (BTAM and VTAM). 


ISC 

generates the following programs for intersystem 
communication support and for DL/I shared data base support 
in CICS/OS/VS: 


• DFHMIR - mirror transaction 

• DFHCRNP - inter-region new connection program 

• DFHCRSP - inter-region control initialization program 

(DL/I shared data base only) 


JOURNAL 

generates the following programs associated with the 
journal control functions 


• DFHJCBSP 

• DFHJCC 

• DFHJCEOV 

• DFHJCI 

• DFHJCIOE 

• DFHJCKOJ 

• DFHJCO 

• DFHJCSDJ 


journal tasks "boot strap" program 
journal control close program 
journal control EOV program 
journal control input program 
journal control I/O error program 
journal control "kick-off" program 
journal control open program 
journal control shutdown program 


MASTTERM 

provides PROGRAM=DFHMTPA through DFHMTPG for the master 
terminal function. 

MSWITCH 

generates PROGRAM=DFHMSP for the message switching program. 
This option also generates the group of programs for the 
BMS function. 

OPENCLSE 

generates PROGRAM-DFHOCP for the dynamic open/close 
function. 


PL/1 

generates the programs listed in the PPT section of 
Appendix A to provide PL/I support in CICS/VS. 

RECOVERY 

generates the following PROGRAM names associated with the 
recovery/restart facility in CICS/VS: 


• DFHRUP - recovery utility program 

• DFHTSRP - temporary storage recovery program 

• DFHTDRP - transient data recovery program 

• DFHTBP - transaction backout program 


RESEND 

generates PROGRAM=DFHZRSP for the VTAM resend program. 
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RESPLOG 

generates PROGRAM=DFHZRLG for the VTAM response logging 
program. 

SIGNON 

generates the program names associated with the sign-on 
program. The programs generated are: 


• DFHSFP - sign-off program 

• DFHSNP - sign-on program 

• DFHSNT - sign-on table 


TIME 

generates PROGRAM=DFHTAJP for the time adjustment program. 

VTAM 

generates PROGRAM=DFHZNAC and DFHZNEP for the VTAM node 
abnormal condition and node error programs and DFHGMM for 
the VTAM good morning sign-on message program. 

VTAMPRT 

generates DFHCPY , DFHEXI, DFHPRK, and DFHRKB for the VTAM 
3270 terminal control print key function. 


END OF PROCESSING PROGRAM TABLE — DFHPPT TYPE=FINAL 


The end of the processing program table is indicated to the control 
system by the DFHPPT TYPE=FINAL macro instruction, which is the last 
statement in the assembly of the processing program table before the 
assembler END statement. This macro instruction creates a dummy entry 
to signal the end of the table. 

r - r - r - n 

I |DFHPPT j TYPE=FINAL | 

t-l-L_J 


TYPE=FINAL 

indicates the end of the processing program table. 


EXAMPLE 

| Figure 3.2-12 illustrates the coding that is required to create a 
processing program table. The programs include: 

• Four assembler-language programs, one of which is resident 

| • Four ANS COBOL programs 
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DFHPPT TYPE=INITIAL 

DFHPPT TYPE=ENTRY, * 

PR0GRAM=C0BPGM1, * 

PGMLANG=COBOL 

DFHPPT TYPE 32 ENTRY, * 

PROGRAM=COBPGM2, * 

PGMLANG 32 COBOL 

DFHPPT TYPE=ENTRY, * 

PROGRAM=COBPGM3, * 

PGMLANG=COBOL, * 

RELOAD=YES 

DFHPPT TYPE=ENTRY, * 

PROGRAM=COBPGM4, * 

PGMLANG=COBOL 

DFHPPT TYPE 32 ENTRY, * 

PROGRAM=DFHACP 

| DFHPPT TYPE=GROUP, * 

| FN=TIME 

DFHPPT TYPE=ENTRY, * 

PROGRAM=DFHMTPA, * 

RES=YES 

DFHPPT TYPE=ENTRY, * 

PROGRAM 32 DFH SNP 

DFHPPT TYPE=ENTRY, * 

PROGRAM 32 DFH Z NAC 

DFHPPT TYPE=ENTRY, * 

PROGRAM=DFHZRLG 

| DFHPPT TYPE=GROUP, * 

| FN=STANDARD 

DFHPPT TYPE=FINAL 
| END 

| Figure 3.2-12. Processing Program Table - Example 


SIT " SYSTEM INITIALIZATION TABLE 


The initialization of CICS/VS is both flexible and dynamic. The 
flexibility at the time of initialization is provided by the system 
initialization table (base name: DFHSIT)• The contents of the DFHSIT 
macro instruction, which is assembled as a table, supplies the system 
initialization program with the information to initialize the system to 
suit the user*s unique environment. During the initialization process, 
the user is given an opportunity to change some of the parameters 
dynamically, as required. 

The information contained in DFHSIT may be grouped into three 
categories for purposes of discussion: 

• Information used to initialize and control system functions (for 
example, storage cushion size, partition/region exit time interval, 
and so on). 

• Module suffixes used to load the user-specified version of the 
CICS/VS control modules and tables (for example, DFHPCTxx, 

DFHFCPxx, and so on). 

• Special information used to control the initialization process. 

The user also has the flexibility of generating several system 
initialization tables and selecting the appropriate one at the time of 
initialization. 
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DFHSIT 


TYPE= t CSECT |DSECT}] 

[,ABKPOPT={NO]YES}] 
t,AKPFREQ={0|decimal-value}1 
{,ALT={NOjxx}] 
t,AMXT=decimal-value] 

t.APPLID={ name-specified-in-DFHTCT TYPE=INITIAL I name}] 
f, ATP=([(NOj YES}] f [{COLD j WARM}])] 

(,ATPMB=decimal-value] 

[,ATPMT={1|number}3 
[,BFP={bb|xx|NO}] 

(.BMS=(({NO|YES}],{{COLD|WARM}])] 

(,CMXT=(Vl,V2,....V10)] 

[,CSA=([{Mb|xx}],{{COLD|WARM}J)] 

{,DATFORM={mmddyy|ddmmyy|yymmdd}] 

{,DBP=(NO|xx}] 

[.DBUFS2={500Innnn}] 

(,DCP={»b|xx|NO}] 

{,DCT=(t{bb|XX|NO}] r [{COLD|WARM}])] 
t,DIP={{NO|YES j xx}] 

{.DL1=({{NQ|YESlxx}].(COLD))] 

( f DSB={Kb|xx}] 

{,EXEC={YES|NO}] 

(,F2260={NO|YES|xx}] 

(,fcp={ bb|xx}] 

{,FCT=(({bb|xx|NO}],{{COLDIWARM}])] 

{,FDP=([xx],({tPARTN]C. FORMAT ]|(FULL]|[NO]} 

I,{SNAP]PDUMP}]] 

[,FLDSEP={" bbbb *|"xxxx *}] 

[,FLDSTRT={"b *|'character’ }] 

{,ICP=(({ W$|xx}],[{COLD|WARM}])] 

[,ICV=( 1000 1 decimal-value}] 

(.ICVR={ 5000 1 decimal-value}] 

{,ICVS={20000]decimal-value}] 

[,ICVTSD=(0|decimal-value}] 

[,IIP={KM|xx}] 

C,ISC=(NOj xx|bb}] 

[ r JCP={Mb|xx}] 

[.JCT=((bblxxlNO}.[{ TAPE I DISK}])] 

( r KCP={»b|xx}] 

[,KPP={MM|xx|NO}] 

[,M32={bb|xx}] 

[,MCP=(MM|xx}] 
t,MSGLVL={l|2|0}] 

[,MXT={5]decimal-value}] 

[.NLT=(NO Ixx}] 
t,PBP={«b]xx}] 

{,PCP={«0]xx}] 

(,PCT= ( { {kSb| xx} ] , t (COLD | WARM} ] ) ] 

{,PGCHAIN=character(s)1 
( , PGCOPY=character(s)] 

(,PGPURGE=character(s)] 
t,PGRET=character(s)] 

[.PGSIZE={ 20tt8 1 4096}] 

{ r PLI={NO|YES}] 

C,PLTPI={NO|xx}] 

{,PLTSD={N0|XX}J 

(.PPT=([{bb|xx}3.({ COLD IWARMIHOT}])] 

(,PRINT=(NO|YES|PAl|PA2|PA3}] 
t,RLR={Kb|xx}] 

(,SCP={)Sb|xx}] 

[.SCS={ 500 1 decimal value}] 

(,SIMODS=( A1.B1.C1.D1.E1.F1.G1.H1.I1.Jl) I(phase, 
phase,phase,phase,phase,...)] 
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j | | [,SKRxxxx=*page-retrieval-command*] 

| | | t,SRP=t)tfb|xx}] 

| | | t,SRT=t«K|xx|NO}] 

j j j t.START={ COLD 1 WARM}] 

| | | [,SUFFIX=xxl 

| | | [,SVD= CNO| YES|nn}] 

| | | C,TCP=CW6|xx|NO}] 

| j j C,TCT=aCbb|xx}] , ({COLD|WARM}])! 

| | | [,TDP={fcfc|xx>] 

1 | | C,TPP={15lJ|xx}] 

j j | t,TRP= (l Cbb|xx}] , ( CON|OFF}] , [ CON|OFF|AUX}]) 3 

j j j (,TRT=CO(decimal-value}] 

j j j C,TSMGSET=C4|number}] 

| | j C,TSP=<{{Jtfb|xx|NO}],CCCOLD|WARM}])] 

j j j t,TST=CNO|YES|xx}] 

j j j [,WRKAREA={512|number)] 

| | | [,XLT=CNO|xx}3 

| | j [,ZCP=Cbb|xx>] 

I I I 

j j j For DOS/VS Only 

1 I I 

I j j [,ICVSWT={401decimal-value}] 

j j j I,NSD=C9|number}] 

I I I 

j j j For OS/VS Only 

I I I 

j j j C,BUFPL=C8|number}] 

j j j [,CICSSVC=nuraber] 

| | J t,DDIR=xxl 

j j | [,DLTHRED=C1|decimal-number}] 

| | | [,DMBPL=C4|number}] 

| | | C,ENQPL=C2|n}] 

j j j [,IOCP=CO|number}] 

j j j [,IRCSTRT=CNO|YES}] 

j j j [.QSCOR= C 819 2 1 decimal-value}] 

j | j C,PDIR=XX] 

j | I [,PISCHD=CNO|YES}] 

| | | [,PLISHRE={NO|YES}] 

| | | C , PSB= CCICSPSB|name}] 

j j j [,PSBPL=C4|number}] 

j | j C,SRBSVC=number] 


Notes ; 

1. When the dummy version of a module is to be included in the system 
initialization table (either while generating DFHSIT or in the 
override parameters during start-up time ), “Module name" =NO and 
not "Module name" =DY should be specified, unless the function to 
be dummied has an associated table. If it does, "Table name" =NO 
should be specified and nothing need be specified for "Module 
name". 


Example without table: KPP=NO or DCP=NO 
Example with table: FCT=NO or DCT=NO 


Chapter 3.2. DFHSIT 


197 




2. The following parameter descriptions apply to the modules that 
refer to Note 2. 

1) The operand indicates that a suffixed version or a dummy module 
may be loaded. 

xx 

indicates a one- or two-character suffix which is appended 
to the standard name before loading the CICS/VS nucleus. 

For example, KCP=B1 causes the DFHKCPBl task control module 
to be included in the CICS/VS nucleus. 


In each case the default suffix is 1616 9 although these 
blanks cannot be specified in the DFHSIT macro except 
within quotes. 


indicates that a dummy module is to be loaded. For 
example, FCT=NO, SRT=NO, JCT=NO, and DCT=NO causes a dummy 
FCP, a dummy SRP, a dummy JCP, and a dummy TDP to be 
loaded, respectively. 

Note that when the suffix option is specified with other 
parameters, the two parameters must be enclosed within 
parentheses: for example, JCT=(xx,DISK). 


2) The operand specifies the type of start that the system 

initialization program will make for that facility. The default 
is the option specified in the START operand. 

COLD 


indicates a cold start 


WARM 


indicates a warm start 

Note : Individual facilities may differ from the value 

specified in the START parameter. Example: START=COLD and 
FCT=(01,WARM)• In this case the FCT would be warm started, 
while the default for the facilities not specified is a cold 
start. 


TYPE =CSECT |DSECT 

indicates the type of system initialization table to be 
generated. The default is CSECT. 

CSECT 

indicates a regular control section and is normally used. 
DSECT 

indicates a dummy section. 

If alternate or additional system initialization modules 
are coded by the user, a DSECT may be required to provide 
symbolic addressability to values in the table. 
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| ABKPOPT=NO|YES 

specifies whether keypointing is to be performed during an 
abnormal termination intercepted by the system recovery program 
(DFHSRP). The default is ABKPOPT=NO. 


NO 

indicates that keypointing will not be used with DFHSRP. 

YES 

indicates that keypointing will be used with DFHSRP. 


| AKPFREQ=decimal-value 

specifies how frequently activity keypoints are to be taken. 
If AKPFREQ=0 (which is the default) is specified, no activity 
keypoints will be taken. If AKPFREQ is a value other than 
zero, it specifies the number of consecutive write operations 
to the system log data set which will trigger the activity 
keypoint function. The range is 200 to 65535. 


| ALT=NO | xx 

specifies the application load table used to control the load 
order of resident application programs. The default is ALT=NO. 

NO 

indicates that the PPT table is used to determine the load 
order of resident application programs. 

xx 

is a one- or two-character suffix that specifies which 
application load table is to be used. 


AMXT=decimal-value 

specifies the maximum number of tasks (excluding journal 
control tasks and the terminal control task) that CICS/VS will 
inspect during its dispatch scan? that is, the maximum number 
of tasks that CICS/VS will allow to be active concurrently. The 
value specified in the MXT operand (see below) sets a limit on 
the number of tasks that CICS/VS will initiate concurrently 
(that is, put into the active chain). The AMXT value controls 
the number of initiated tasks that CICS/VS will consider for 
dispatching. 

This parameter is especially useful in a conversational CICS/VS 
environment where the maximum task value (MXT=) is not an 
effective tuning tool, and would normally be set higher than 
the number of concurrent tasks the system is capable of 
servicing effectively. 

The maximum active task value can be used by the conversational 
CICS/VS environment to control the load on CICS/VS without 
limiting the number of terminals in use. 

If the maximum active task value is set too low in an 
environment where tasks can wait for the completion of events 
being processed by other tasks, a lock-out situation can occur. 
It occurs mostly when one task attaches another and then waits 
for the completion of an event processed by the new task. The 
new task may be locked-out from running because of the presence 
of enough tasks of the first type to equal the maximum active 
task number. The user can prevent this situation by using a 
sufficiently high maximum active task value (AMXT) and/or a 
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class maximum task value (CMXT), that is lower than the maximum 
active task value, on tasks which wait for events from other 
tasks. 

The default value for the number of maximum active tasks is 
equal to the maximum task value. The range is 1 to 999. 


APPLID=name 

specifies a one- to eight-character application name defined to 
VTAM during VTAM system definition and identifies CICS/VS to 
VTAM as an application program. This operand must be used if 
APPLID=name is not specified in the DFHTCT TYPE=INITIAL macro 
instruction, and may also be used at system initialization to 
override this specification. APPLID is also the name by which 
the CICS/VS system is known to other CICS/VS systems, including 
the batch system (for DL/I shared data base support in 
CICS/OS/VS). The name specified in this operand should be the 
same as that in the NETNAME operand in DFHTCT TYPE^ISLINK or 
DFHTCT TYPE=TERMINAL for the remote system in an intersystem 
communication session. 


| ATP=NO|YES|COLD|WARM 

specifies whether the asynchronous transaction processing 
facility (ATP) is to be supported. The default is ATP=NO. 

NO 

indicates that ATP support is not desired. 

YES 

indicates that ATP support is desired. 

COLD 

indicates a cold start. 

WARM 

indicates a warm start. 


ATPMB=number 

specifies, as a decimal value, the asynchronous task inhibitor 
value. When the number of active tasks (both synchronous and 
asynchronous) reaches this level, the asynchronous transaction 
processing control program (DFHATP) does not initiate any new 
asynchronous tasks, even though the number of asynchronous 
tasks currently active is less than the value specified in the 
ATPMT operand. Thus, even though no asynchronous tasks are 
active, none are initiated if the total of all other active 
tasks has reached the level specified in this operand. The 
default value is equal to one less than the value specified in 
the MXT operand. The range is 1 to 998. ATPMB must be less 
than MXT. 


ATPMT=number 

specifies, as a decimal value, the maximum number of 
asynchronous tasks that can be initiated concurrently within 
CICS/VS by the asynchronous transaction processing control 
program (DFHATP)• When the number of active asynchronous tasks 
reaches this level, no new asynchronous tasks are initiated by 
DFHATP. The default is ATPMT=1. The range is 1 to 998. ATPMT 
must be less than or equal to ATPMB. 
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| BFP=fcb|xx|NO 

j built-in functions program suffix - see Note 2 at the beginning 

| of the description of this macro. 


| BMS=NO|YES|COLD|WARM 

specifies whether basic mapping support is to be included. 

This operand determines whether the BMS modules will be loaded. 
The BMS modules (IIP, MCP, M32, PBP, RLR, DSB, and TPP) are 
individually suffixable. The default is BMS=NO. 

NO 

indicates that a dummy basic mapping support module is to 
be loaded. 

YES 

indicates that basic mapping support will be included. 


COLD 

indicates cold start BMS ICEs. 

WARM 

indicates warm start BMS ICEs. 


CMXT=(Vl,V2,V3,V4,V5,V6,V7,V8,V9,V10) 

specifies the maximum number of tasks that may be active in any 
of the ten transaction classes. The options are positional and 
must be enclosed in parentheses. This means that the first 
position applies to class 1, the second to class 2, and so on, 
up to class 10. The value specified for each class may be from 
1 to 999, but must not exceed the maximum task value (MXT). 

The default is 1. 

Example: 

CMXT=(5,,,3,,4,,8,,6) 

where class 1 is set to 5, class 4 to 3, class 6 to 4, class 8 
to 8, and class 10 to 6. Classes 2, 3, 5, 7, and 9 default to 
1 . 

The use and purpose of the classes are entirely at the 
discretion of the user. The following is an example of how the 
classes may be used: 


1 

2 

3 

4 

5 through 10 


Inquiry-only transactions 
Update or add transactions 
File browse or weighted retrieval 
transactions 

Auto-initiated tasks (such as ICP or TDP 
transactions) 

Could be used to group transactions by 
other characteristics (such as similar 
working set sizes) 


| CSA=bb j XX1 COLD|WARM 

common system area suffix - see Note 2 at the beginning of the 
description of this macro. 
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| DATFORM=month/day/year 

j specifies the external date display standard desired by the 

| user. An appropriate indicator setting is made in the CSA. It 

j is examined by CICS/VS supplied system service programs that 

| display a Gregorian date. As part of their operation, the 

| indicator can also be examined by customer-written programs. 

| It is the user's responsibility to supply a Gregorian date 

j conversion routine because CICS/VS maintains the date in the 

j form YYDDD in the CSA. The default is the format used in the 

| DATFORM operand of DFHSG PROGRAM=CSA. 

| mmddyy 


1 

indicates 

the 

date 

will 

be 

in 

the 

form 

of 

month day year. 

1 

1 

ddmmyy 

indicates 

the 

date 

will 

be 

in 

the 

form 

of 

day month year. 

1 

1 

yymmdd 

indicates 

the 

date 

will 

be 

in 

the 

form 

of 

year month day. 


| DBP=NO1xx 

indicates which version of the dynamic transaction backout 
program (if any) is to be part of the system. If SUFFIX=xx is 
specified, an entry for that dynamic transaction backout 
| program (DFHDBPxx) must be made in the PPT. 


| DBUFSZ=number 

indicates the size in bytes of the dynamic buffer that is used 
| by dynamic transaction backout. The default is 500. The size 

j of the buffer should be large enough to accommate a copy of 

j each file or DL/I record that is updated in a typical LUW and 

j is written to the dynamic log. If the data exceeds the 

| specified buffer size, records spill on to temporary storage, 

j The size of the buffer to be specified should be weighed 

j against the overheads of using too much main storage and 

| spilling too often on to temporary storage. Further 

| information on the dynamic log can be found under "User Exits 

j for Dynamic Transaction Backout" in Chapter 4.4. 


500 

indicates that the size of the dynamic buffer is 500 bytes, 
nnnnn 

indicates the size of dynamic buffer and should be in the 
range 6 to 32000. 


| DCP=bb|N0|xx 

dump control program suffix - see Note 2 at the beginning of 
j the description of this macro. If DCP=NO is specified, a 

| formatted dump will not be taken. 


| DCT=bb|xx|NO|COLD j WARM 

destination control table suffix - see Note 2 at the beginning 
of the description of this macro. 


| DIP=NO|YES|xx 

batch data interchange program suffix - see Note 2 at the 
beginning of the description of this macro. 
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| DL1=N0|YES|XX|COLD 

indicates whether Data Language/I (DL/I) data bases are to be 
accessed during execution of CICS/VS. The default is DL1=N0- 
This parameter should not be specified if DL/I ENTRY is being 
used. 


NO 

indicates that DL/I will not be used. 

YES 

indicates that DL/I will be used. 


xx 

indicates for DOS/VS only, a one- or two-character suffix 
to be appended to the DOS/VS DL/I nucleus module DLZNUC. 


COLD 

indicates a cold start. The default is the option specified 
in the START= operand. 

Note: Either "DLl" or "DLI" can be used. 


i 


DSB=bb|xx 


data stream builder (BMS) suffix - see Note 2 at the beginning 
of the description of this macro. 


EXEC=YES|NO 


indicates whether command (EXEC) level transactions are to be 
run. The default is YES. 


YES 

indicates that command (EXEC) level support is required. 


indicates that command (EXEC) level support will not be 
used. This option must not be specified if DL/I shared 
data base support or intersystem communication support is 
required. 


| F2260=NO|YES|xx 

specifies whether FASTER 2260 compatibility modules are to be 
included. FASTER 2260 modules (FIP and F2P) are suffixable. 
The default is F2260=NO. 


NO 

YES 


xx 


indicates no FASTER 2260 compatibility. 


indicates that FASTER 2260 support is to be included 
(modules FIP and F2P are not suffixed). 


indicates the suffixes which will be appended to modules 
DFHFIP and DFHF2P. 


I Fcp=bb|xx 

file control program suffix - see Note 2 at the beginning of 
the description of this macro. 
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| FCT=bb|XX|NO|COLD|WARM 

file control table suffix - see Note 2 at the beginning of the 
description of this macro* 


FDP=XX | PAJRTN | FORMAT | FULL | NO | SNAP | PDUMP 

specifies the type of dump that is to be produced if CICS/VS 
terminates abnormally, if a system abend or storage violation 
occurs, or if CSMT SNAP with no parameters is entered. For an 
abnormal termination or an unrecoverable abend, CICS/VS 
terminates after the dump is completed. In the other cases, 
CICS/VS continues normally after the dump is completed. The 
default is FORMAT. 

xx 

specifies the two-character suffix for the formatted dump 
program (DFHFDP). 

Note : The formatted dump program provided by CICS/VS is 

unsuffixed; the suffix should only be used for user-written 
or user-modified versions of the formatted dump program. 

PARTN 

requests a dump of the CICS/VS partition. 

FORMAT 

requests a formatted dump only. This is a dump of the 
major CICS/VS control blocks arranged in a logical order. 
The hexadecimal offsets of the major fields in each control 
block are displayed together with the contents of the 
fields. The formatted dump program also checks for errors 
in the contents of the control blocks. 


FULL 

requests both a partition dump and a formatted dump. This 
provides the functions of both PARTN and FORMAT. 

Note : This function was provided by "FORMAT" in Version 1, 

Release 2 of CICS/VS. 


NO 

requests a CANCEL or ABEND dump, but only in the case of an 
abnormal termination. If CSMT SNAP is issued, no dump will 
be produced. 

SNAP or PDUMP 

requests that, when a partition dump is invoked as a result 
of a PARTN request, the formatted dump program should issue 
a SNAP (OS/VS) or PDUMP (OS/VS) request instead of writing 
the dump to the dump data set. 

Note : The output of the formatted dump program is normally 

directed to the dump data set via the dump control program 
unless FDP=(,NO) is specified. If a dummy dump control program 
is used (DCP=NO in this macro) no formatted dumps will be taken 
either." 
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FLDSEP= 1- xxxx* 

specifies one to four field-separator characters, each of which 
indicates end-of-field in the terminal input data. This 
enables the use of transaction identifications of less than 
four characters followed by one of the separator characters. 
When less than four characters are specified, the parameter is 
padded with blanks. This means that a blank becomes a field 
separator. (See also "Input Formatting" under "CICS/VS Built- 
In Functions" in the CICS/VS Application Programmer"s Reference 
Manual.) The default is four blanks. 


FLDSTRT= f character■ 

specifies the single character considered to be the field-name- 
start character by free-form input for built-in functions. The 
default is one blank. 

Note : The character specified in the FLDSTRT parameter must 

not be the same as any character specified in the FLDSEP 
parameter. This means it is invalid to allow both parameters 
to take the default value- 


ICP=bb|xx,COLD|WARM 

interval control program suffix - see Note 2 at the beginning 
of the description of this macro. 


ICV=decimal-value 

specifies the partition/region exit time interval in 
milliseconds. The partition/region exit time interval is the 
maximum interval of time for which CICS/VS releases control to 
the operating system in the event that there are no 
transactions ready to resume processing. This time interval 
can be any three- to seven-digit decimal value in the range 
from 100 to 2700000 milliseconds (the default is ICV=1000). A 
typical range of operation might be 100 to 2000 milliseconds. 
The value chosen must not be greater than the values specified 
in the ICVR and ICVS operands. 

A low value interval can enable much of the CICS/VS nucleus to 
be retained in dynamic storage, and not be paged out at times 
of low terminal activity. This reduces the amount of dynamic 
storage paging necessary for CICS/VS to process terminal 
transactions (thus representing a potential reduction in 
response time), sometimes at the expense of concurrent batch 
partition/region throughput. Large networks with high terminal 
activity are inclined to drive CICS/VS without a need for this 
value, except to handle the occasional, but unpredictable, 
period of inactivity. These networks can usually function with 
a large interval (10000 to 30000 milliseconds). Once a task 
has been initiated, its requests for terminal services and the 
completion of the services are recognized by the system and 
this maximum delay interval is overridden. 
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Small systems or those with low terminal activity are subject 
to paging introduced by other jobs running in competition with 
CICS/VS. By specifying a low value interval, key portions of 
the CICS/VS nucleus are referenced more frequently, thus 
reducing the probability of these pages being paged out. 
However, the execution of the logic, such as terminal polling 
activity, without performing productive work might be 
considered wasteful. The need to increase the probability of 
residency by frequent, but unproductive referencing must be 
weighed against the overhead and response time degradation 
incurred by allowing the paging to occur. By increasing the 
interval size, less unproductive work is performed at the 
expense of performance if paging occurs during the periods of 
CICS/VS activity. 

Note : If the terminal control negative poll delay feature is 
used, the ICV value selected should not exceed the negative 
poll delay value. If the negative poll delay used is zero, any 
ICV value may be used. 


ICVR=decimal-value 

specifies the runaway task time interval in milliseconds as a 
decimal value. If ICVR=0, runaway task control is suspended 
for the duration of the current execution of CICS/VS. The 
| default is ICVR=5000. The range is 0 to 2700000. The value 

j chosen must not be less than the value in the ICV operand, and 

j will be rounded down to the nearest multiple of 10 

j milliseconds. For further information, see the CICS/VS 

Operator's Guide . 


I CVS=decimal-value 

specifies the system stall time interval in milliseconds as a 
decimal value. The default is ICVS=20000. The range is 0 to 
J 327670. The value chosen must not be less than the value in 

I the ICV operand, and will be rounded down to the nearest 

j multiple of 10 milliseconds. For further information, see the 

CICS/VS Operator's Guide . 


i 

i 

i 

i 

i 

i 

i 


ICVTSD=decimal-value 

indicates that the terminal scan delay facility is required. 
This is an alternative to the full ICV value, and represents 
the interval after which CICS/VS will scan the TCT again after 
it has finished processing to service BTAM output requests. A 
tradeoff should be made between improved response times on 
output and increased processor utilization. A value of close 
to 0 is recommended. The range is 0 through 100000 
milliseconds, with a default of ICVTSD=0. 


| IIP=tSb|xx 

input independence program (BMS) suffix - see Note 2 at the 
beginning of the description of this macro. 


| ISC=NOIxxIbb 

j intersystem communication group suffix for DFHISP, DFHELR, and 

j DFHXFP. 


| jcp=bb|xx 

journal control program suffix - see Note 2 at the beginning of 
the description of this macro. 
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| JCT=fcb|xx 


specifies a journal control table which contains information 
about journal files or data sets. See also Note 2 at the 
beginning of the description of this macro. 

TAPE 

specifies for emergency restart purposes that the system 
log resides on tape. 


DISK 

specifies for emergency restart purposes that the system 
log resides on disk. 


| KCP=bb|xx 

task control program suffix - see Note 2 at the beginning of 
the description of this macro. 


| KPP=bb|xx|NO 

keypoint program suffix - see Note 2 at the beginning of the 
description of this macro. 


J M32=bb|xx 

3270 mapping (BMS) suffix - see Note 2 at the beginning of the 
description of this macro. 


| MCP=bb|xx 

mapping control program (BMS) suffix - see Note 2 at the 
beginning of the description of this macro. 


| MSGLVL=number 

specifies a message level which controls the generation of 
messages to the console during system initialization. The 
default is MSGLVL=1. 

2 

indicates that all messages are to be printed on SYSLST and 
SYSLOG (DOS/VS only). 

1 

indicates that all messages are to be printed. 

0 

indicates that only critical I/O errors or interactive 
messages are to be printed. 


MXT=decimal-value 

specifies the maximum number of tasks (both synchronous and 
asynchronous) that can be initiated concurrently within 
CICS/VS. When the number of tasks reaches this level, no new 
tasks are initiated by the terminal control program. The 
default is MXT=5. The range is 2 to 999- 

Note: In a system using journaling, the maximum number of 

tasks must include one task for journaling and one task for 
each journal. 
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| NLT=NO1xx 

specifies a nucleus load table. The table is used to control 
the load order of the CICS/VS nucleus. The default is NLT=NO. 

NO 

indicates that the default load order is to be used. The 
default load order is described in the nucleus load table 
macro earlier in this chapter. 

xx 

is a one- to two-character suffix which specifies which 
nucleus load table is to be used. 


| PBP=fcb*xx 

page build program (BMS) suffix - see Note 2 at the beginning 
of the description of this macro. 


| PCP=bb|xx 

program control program suffix - see Note 2 at the beginning of 
the description of this macro. 


| PCT=bb|xx|COLD|WARM 

program control table suffix - see Note 2 at the beginning of 
the description of this macro. 


| PGCHAIN=character(s) 

is the character string which is to be recognized by terminal 
control as a terminal page-chaining command. It can be from 
one to seven characters. 


| PGCOPY=character Cs) 

is the character string which is to be recognized by terminal 
control as a command to copy output from one terminal to 
another. It can be from one to seven characters. 


PGPURGE=characters 

is the character string which is to be recognized by terminal 
control as a terminal page-purge command. It can be from one 
to seven characters. 


| PGRET=character(s) 

is the character string which is to be recognized by terminal 
control as a terminal page-retrieval command. It can be from 
one to seven characters. 


Notes : 

1. Each character string should be unique with respect to the leading 
characters of every other transaction identification defined in the 
program control table (DFHPCT5. In particular, it should be noted 
that a command requested by a single character precludes the use of 
all other transaction identifications starting with this character. 
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2. A field separator or other suitable delimiter may be specified in 
each character string in order to separate this command code from 
the remainder of the paging command when entered by an operator. 
For example: 

PGCHAIN = X/ 

PGCOPY = C/ 

PGPURGE = T/ 

PGRET = P/ 

This also reduces the risk of creating a non-unique command (see 
Note 1). 

3. PGCHAIN, PGCOPY, PGPURGE, and PGRET cannot be changed at execution 
time. These operands are only required if PAGING=YES is specified 
for the DFHSG PROGRAM=BMS macro instruction. For further 
information see the CICS/VS Operator's Guide . 

| 4. CICS/VS will always process a paging command entered by the 

| operator before initiating a transaction in response to a macro 

| request which consists of either DFHBMS or DFHPC with the TRANSID 

| operand specified. 


PGSIZE=size 

indicates a decimal value for the number of bytes in the 
operating system* s virtual storage pages.. The default is 
PGSIZE=2048. 


| PLI=NO|YES 

specifies whether PL/I programs are to be processed. The 
default is PLI=NO. 

NO 

indicates that no PL/I programs are to be processed. 

YES 

indicates that PL/I programs are to be processed. 
Note : Either "PL1" or "PLI" can be used as keywords. 


| PLTPI=NO | xx 

specifies a program list table which contains a list of 
programs to be executed after system initialization processing. 
The default is PLTPI=NO. 

NO 

indicates that the facility is not provided, 
xx 

indicates a one- or two-character suffix to specify which 
program list table is to be used. 


| PLTSD=NO|xx 

specifies a program list table which contains a list of 
programs to be executed during system termination. The default 
is PLTSD=NO. 

NO 

indicates that the facility is not provided. 
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XX 


indicates a one- or two-character suffix to specify which 
program list table is to be used. 


| PPT=W IXXI COLD I WARM I NOT 

processing program table suffix - see Note 2 at the beginning 
of the description of this macro. In addition, the HOT option 
may be specified in this entry to indicate that the facility 
may be HOT started by using the information saved by the 
keypoint program CKPP) in a warm keypoint, which is read at 
system initialization. 


PRINT^NOl|YES j PAl|PA21PA3 

specifies methods of requesting 3270 printout. The default is 
PRINT=NO. 

NO 

specifies that print support is not required. 

YES 

specifies that the support required is limited to terminal 
control print requests. 

PAl, PA2, or PA3 

specifies that support is to be provided for the terminal 
operator print request via the specified program attention 
key as well as the terminal control print request. 

The 3270 print-request facility allows either the application 
program or the terminal operator to request a printout of data 
currently displayed on the 3270 display. This facility is not 
supported for TCAM devices. 

For a BTAM 3270 display, the PRINT request will print the 
contents of the display on the first available print-request- 
eligible 3270 printer on the same local or remote 3270 control 
unit. For a printer to be considered available, it must be in 
service and not currently attached to a task. For a printer to 
be considered print-request-eligible, it must be on the same 
control unit, have a buffer capacity equal to or larger than 
the 3270 display, and must have FEATURE^PRINT specified in its 
terminal control table terminal entry. 

For a VTAM 3270 display without the printer-adapter feature, 
the PRINT request will print the contents of the display on the 
first available 3270 printer specified by PRINTTO and ALTPRT in 
DFHTCT TYPE=TERMINAL (the PRINTTO printer is tested for 
availability first). For a printer to be considered available, 
it must be in service and not currently attached to a task. It 
is not necessary for the printer to be on the same control 
unit, or to have FEATURE^PRINT specified in DFHTCT 
TYPE=TERMINAL. 
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For the 3275 with the printer-adapter feature, the PRINT 
request will print the data currently in the 3275 display 
buffer on the 3284 Model 3 printer attached to the 3275. This 
operand is valid for both BTAM and VTAM support. 

The format of the print operation will be dependent upon the 
size of the display buffer. For a 40-character wide display, 
the print format will be a 40-byte line, and for an 80- 
character wide display the format will be an 80-byte line. 

For the 3270 compatibility mode logical unit of the 3790 (if 
the logical unit has the printer-adapter feature specified), 
the PRINT request will print the contents of the display on the 
first printer available to the 3790. The allocation of the 
printer to be used is under the control of the 3790. PRINTTO 
and ALTPRT are available for 3270 compatibility mode logical 
units. 

For 3274, 3276, and LUTYPE2 logical units, the PRINT request 
will print the contents of the display on the first printer 
available to the 3790. The printer to be allocated depends on 
the printer authorization matrix. For further information, 
refer to the 3270 Information Display System Component 
Description manual. 

For the 3270 compatibility mode logical unit without the 
printer-adapter feature, see the preceding paragraph on VTAM 
3270 displays without the printer-adapter feature. 

Notes: 


1. A program attention key specified by this operand must not 
also be specified by the TASKREQ operand of the PCT or be 
used for 3270 single keystroke retrieval. 

2. When either YES, PA1, PA2, or PA3 is specified, an 
application program (DFHP3270) is generated, the name of 
which must be entered in the PPT. This program is invoked 
as a transaction (CSPP) which must be entered in the PCT. 

| In the case of 3270 and LUTYPE2 logical units, the 

application programs DFHEXI, DFHCPY (transaction name 
CSCY), DFHPRK (transaction name CSPK) are generated. The 
names of these application programs must be entered in the 
PPT and the transaction names in the PCT. 


| RLR=bb| XX 

route list resolution (BMS) suffix - see Note 2 at the 
beginning of the description of this macro. 


| scp=bb|xx 

storage control program suffix - see Note 2 at the beginning of 
the description of this macro. 


SCS=decimal-value 

specifies the number of bytes which are to be reserved for the 
storage cushion. The default is SCS=500. The range is 20 to 
524288. This value will be rounded up to the operating 
system*s next higher virtual page size. (See the PGSIZE 
operand.) 
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SIMODS=phases 

specifies the sequence of execution and names of system 
initialization overlays. The system initialization overlays 
are seven-character names in the format DFHSIxy, where x is a 
letter between A and Z and y is a number between 1 and 9. If 
additional user-written overlays are added, the CICS/VS- 
supplied user overlay sequence should not be altered. Any 
number of user-written overlays can be interspersed among the 
CICS/VS-supplied ones, and will be called in the sequence they 
are specified in the SIMODS parameter. However, the CICS/VS- 
provided overlay (DFHSIJl) must be the last overlay specified. 
Users should be aware that the sequence names and number of 
CICS/VS-supplied system initialization overlays may change in 
future releases. The default is 
SIMODS=(Al,Bl,Cl,Dl,El,Fl,Gl,Hi,I1,J1). 

Note : Only those system initialization overlays that are 
identified in the sequence list (whether CICS/VS-supplied or 
user-written) will be loaded. 


SKRxxxx= * page-retrieval-command * 

defines a single-keystroke-retrieval operation, xxxx specifies 
a key on the 3270 keyboard that, during a page retrieval 
session, is to be used to represent a page retrieval command. 

| The valid keys are PAl through PA3, and PFl through PF24. Thus 

| up to 27 keys can be specified in this way (each by a separate 

command). 

If one or more keys are to be used to initiate a page retrieval 
session, and therefore dedicated to page retrieval operation, 
an entry for each key must be included in the program control 
table (see Appendix A). 

*page-retrieva1-command* represents any valid page retrieval 
command. It will be concatenated to the character string 
specified in the PGRET= operand. The combined length must not 
exceed 16 characters. 


| SRP=bb|xx 

system recovery program suffix - see Note 2 at the beginning of 
the description of this macro. 

| SRT=NO|YES|nn 

system recovery table suffix - see Note 2 at the beginning of 
the description of this macro. Specifying SRT=NO forces the 
dummy version of the system recovery program (SRP) to be 
loaded. 

Note : The full version of the SRP provides recovery code in 

program check and abnormal termination situations. The dummy 
SRP does neither, although it does issue SPIE (OS/VS) or STXIT 
PC (DOS/VS) macros to intercept program checks to perform 
clean-up operations before CICS/VS goes down. Therefore, an 
SRT must be provided if recovery from program checks and/or 
abnormal termination situations is required. 


| START -COLD 1WARM 

specifies the type of start for the system initialization 
program. The value specified for START or the default of COLD 
becomes the default value for each of the other facilities 
containing the COLD and WARM parameters. 
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COLD 


indicates a cold start. 


WARM 

indicates a warm start. 

Note : Emergency restart is invoked by specifying START=EMER or 

START=(EMER,ALL) as system initialization override parameters. 
For further information, refer to the appropriate CICS/VS 
System Programmer's Guide (DOS/VS or OS/VS). 


SUFFIX=xx 

specifies a one- or two-character alphameric suffix for the 
system initialization table being assembled. This suffix, if 
specified, is appended to the standard module name (DFHSIT) and 
is used to name the module on the linkage editor output 
library. If this operand is omitted, a suffix is not provided. 


SVD=NO|YES|nn 

indicates whether a storage violation dump is required in order 
to assist the user in identifying the cause of a storage 
violation. The default is NO. 

IJO 

indicates that a storage violation dump is not required. 

YES 

indicates that a dump is required each time a storage 
violation occurs. 


nn 

indicates the number of instances that a storage violation 
dump is required for storage violations. 

Note : If storage violation dumps are required, RECOVER= YES 

must be specified in DFHSG PROGRAM=SCP and the DFHSIT macro 
must not include FDP=NO. 


| TCP=bb|xx|NO 

specifies the suffix to be appended to the name of that portion 
of the terminal control program which supports start-stop, BSC, 
TCAM, and TCAM SNA devices. See Note 2 at the beginning of the 
description of this macro. 

| Note : The system programmer should be aware that ZCP does not 

I default to the same suffix as that specified for TCP. An 

j unsuffixed ZCP module is loaded. 


| TCT=bb|XX|COLD J WARM 

terminal control table suffix - see Note 2 at the beginning of 
the description of this macro. 


| TDP=bb|xx 

transient data program suffix - see Note 2 at the beginning of 
the description of this macro. 


| TPP=bb|xx 

terminal page program (BMS) suffix - see Note 2 at the 
beginning of the description of this macro. 
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| TRP=J6J61 xx j ON j OFF | AUX 

indicates whether the trace control facility is required. The 
j module may be suffixed, and, in addition, the ON, OFF, and AUX 

j options may be specified. 

The trace control facility can be turned off at start-up time 
either by a system initialization table parameter (see examples 
that follow), a system initialization override parameter, or 
through the master terminal facilities of CICS/VS. This will 
still allow for debugging facilities if needed, by dynamically 
turning trace on either in an application program or through 
the master terminal facility. 

Examples: 


s 

! 


TRP=AB 
TRP= (AB ,AUX) 
TRP=(AB,OFF) 
TRP=(,OFF) 


Trace control program suffix AB with 
trace on (by default) 

Trace control program suffix AB with 
auxiliary trace on 

Trace control program suffix AB with trace 
initialized off 

Trace control program unsuffixed with 
trace initialized off 


Note : The trace control program will not be entered or 

referenced if trace is turned off, even though full trace 
facilities are available. In terms of processor cycles or 
storage reference patterns, there is no advantage in specifying 
a dummy trace program. 


TRT=decimal-value 

specifies the number of entries which are to be provided in the 
CICS/VS trace table. If this parameter is 0, a dummy trace 
facility is loaded (DFHTRPDY). The default is TRT=0. The 
range is 0 to 10000. See the discussion on trace-table entries 
in Example 1 of the nucleus load table section of this manual. 


TSMGSET=number 

specifies the number of entries for which dynamic storage will 
be allocated for storing pointers to records put to a temporary 
storage message set. When the n entries are used, space is 
acquired for n more entries as many times as required to 
accommodate the total number of records in the queue at any 
point in time. The default is TSMGSET=4. The range is 4 to 
100. For further information concerning temporary storage 
message set entries, refer to the CICS/VS System/Application 
Design Guide . 


s TSP=bb1xxI NOI COLDI WARM 

temporary storage program - see Note 2 at the beginning of the 
description of this macro. 


I TST=NO|YES|xx 

specifies whether the temporary storage table is to be 
included. This operand should not be included if the recovery 
facility of the temporary storage program is not generated. 

The default is TST=N0. 


NO 


indicates that no TST table is required. 
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YES 


indicates that the TST table is to be included (this must 
be specified if the temporary storage program is generated 
| with AUX=REC or if intersystem communication support is 

| required). 

xx 

indicates the 2-character suffix appended to DFHTST. 


WRKAREA=number 

specifies the number of bytes to be allocated to the common 
work area portion of the CSA. This area is for use by the 
installation, is initially set to binary zeros, and is 
available to all programs. It is not used by CICS/VS. The 
maximum size for the work area is 3584 bytes. The default is 
512 bytes. 


| XLT=NO|xx 

specifies a transaction list table. The table contains a list 
of transactions that can be attached during the first quiesce 
stage of system termination. The default is XLT=NO. See Note 2 
at the beginning of the description of this macro. 


ZCP=bb|xx 

specifies the suffix of the ZCP and ZCX modules that are to be 
loaded by SIP. The default is a suffix of two blanks. Because 
ZCP and ZCX are always required (even for non-VTAM support), 
specifying a suffix of NO will not suppress loading. NO will 
be treated as a regular suffix value. ZCA and ZCY are loaded 
without suffixes. 

m 

indicates that no suffix is to be added, 
xx 

indicates the one- or two-character suffix to be added. 


| For DOS/VS only 


ICVSWT=decimal-value 

indicates the period of time after which CICS/DOS/VS regains 
control from DOS/VS to check for completion of a disk I/O 
request made by a transaction. 

A disk I/O normally takes between 20 and 40 milliseconds to 
complete. If a very low "short wait" interval is set, 
unproductive processing may be caused; a high value may cause 
an unnecessary increase in response time. The range is 0 
through 1000 milliseconds, with a default value of 40 
milliseconds. The actual value chosen is dependent on the 
requirements of the individual system. 
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Note ; CICS/DOS/VS will only take as long as the period 
specified in the short wait interval to detect the completion 
of a disk I/O if there is no other activity in the CICS/VS 
system. Therefore, in a high activity system, the short wait 
value should be set to a low value if it is to have any 
noticeable effect. If ICVSWT=0 is specified, the DOS/VS WAIT 
macro will not be issued whenever disk I/O is in progress. A 
value of 0 should only be used after careful consideration of 
the effect it may have on batch partitions. 


NSD=9(number 

specifies the maximum number of nonsequential disk extents that 
will exist for any data set involved in the execution of 
CICS/DOS/VS. CICS/VS system initialization uses this value to 
determine the amount of storage to be reserved at the beginning 
of the partition for label processing when the data sets are 
opened. Although most data sets are opened during system 
initialization, the dynamic open/close feature of the CICS/VS 
master terminal program may need to use this label processing 
area during the execution of CICS/VS. The presence of this 
operand makes it unnecessary for the user to supply a DOS/VS 
LBLTYP job control statement with the CIVCS/VS execution deck. 
The minimum value that may be specified is NSD=1. 

If the NSD operand is specified in both DFHSG PROGRAM=CSO and 
DFHSIT, the number of disk extents specified will be added. 


For OS/VS only 


BUFPL=number 

applicable only if the CICS/OS/VS-DL/I interface is to be used 
| with pre-IMS/VS Version 1.1.4 ISAM and OSAM data bases, this 

operand is used to specify the DL/I data base buffer pool size 
in 1024-byte blocks. The number of 1024-byte blocks specified 
must be in the range 0 to 999. This operand corresponds to the 
DBASE operand of the IMS/VS BUFPOOLS system definition macro 
instruction and to the HHH parameter of the IMS/VS CTL or CTX 
parameter list for online execution. The default is BUFPL=8. 

| This operand has no effect when IMS/VS Version 1.1.4 is used 

I with CICS/VS Version 1, Release 4. IMS/VS uses the value in 

| the IOBF parameter on the DFSVSAMP options card for ISAM and 

| OSAM, and the values on the DFSVSAMP subpool definition 

statement for VSAM. 


CICSSVC=number 

specifies the SVC number to be used for the CICS/VS page-fixing 
or anticipatory paging SVC that CICS/VS will provide. The SVC 
is used if ANTICPG=YES or number is specified in DFHPCT 
TYPE=ENTRY, if RES=FIX is specified in DFHPPT TYPE=ENTRY, or if 
FIX=YES is specified in DFHNLT TYPE=ENTRY. The number may be 
in the range 200 to 255 and may be used to override the CICSSVC 
number specified in DFHSG TYPE=INITIAL; the default is 201. 

Note s This operand only controls the SVC number that certain 
CICS/OS/VS modules use to pass control to the SVC routine that 
is supplied by CICS/OS/VS. It does not alter the name of the 
SVC routine itself (which is derived partly from the SVC 
number). To produce a new SVC routine with a correct name, a 
DFHSG TYPE=INITIAL macro with CICSSVC=number and STATUS=FIRST 
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I 
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must be assembled. The Stage 2 jobs that are produced must 
then be run. 


| The CICSSVC operand of DFHSIT makes CICS/OS/VS nucleus modules 

| independent of the SVC number. 


DDIR=suffix 

specifies a suffix for the DDIR list and is applicable only if 
the CICS/OS/VS-DL/I interface is to be used. The default is a 
blank suffix. 


DLTHRED=number 

specifies the number of strings (1 to 15) provided through the 
DL/I interface, and is applicable only if the CICS/OS/VS-DL/I 
interface is to be used. The default is 1. The value 
specified in this operand must be large enough to accommodate 
the online DL/I usage plus the shared data base requirements; 
that is f a number of threads equivalent to the number specified 
in the SESNUMB operand in the DFHTCT TYPE=IRCBCH macro. 


DMBPL=number 

applicable only if the CICS/OS/VS-DL/I interface is to be used, 
this operand specifies the data management block (DMB) pool 
size in 1024-byte blocks for CICS/OS/VS-DL/I interface support. 
The number of 1024-byte blocks specified must be in the range 0 
to 999. This operand corresponds to the DMB operand of the 
IMS/VS BUFPOOLS system definition macro instruction and to the 
JJJ parameter of the IMS/VS CTL or CTX parameter list for 
online execution. The default is DMBPL=4. 


ENQPL=n 

indicates the maximum size (in K bytes) to be allocated by 
IMS/VS for ENQ control block space. ENQ control blocks are 
heavily used when program isolation scheduling (PISCHD=YES) is 
to be used for DL/I transactions. This parameter is identical 
to the second sub-parameter of the CORE operand of the IMSCTF 
macro, and is provided in CICS/VS because the IMSCTF macro is 
not available for IMS/VS DB users. The default value is 
ENQPL=2. 

For further information on how to calculate the ENQPL value, 
refer to the IMS/VS System Programmers Reference Manual . 


IOCP=number 

specifies the percentage of DASD I/O events that the task 
control program will wait on. The value of IOCP may be from 0 
to 50%. (0% is a wait count of one and 50% is a wait count 

equal to half the number of outstanding DASD I/O events,.) The 
default is IOCP=0. 


IRCSTRT=NO|YES 

indicates whether the inter-region environment that will be 
used in a shared data base session between CICS/OS/VS and the 
DL/I batch region will be started-up at system initialization. 
The default is NO. If IRCSTRT=YES is not specified, the inter¬ 
region environment can be initialized by issuing a CSMT 
(IRC,BEGIN) command. 
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Note that initializing the inter-region environment involves 
the allocation of the (potentially large) control blocks 
discussed in the DL/I shared data base section of the OSCOR 
operand (below)* If storage availability is crucial, the CSMT 
(IRC,BEGIN|END) command should be used to minimize the time 
during which storage is allocated. 


OSCOR=decimal-value 

| specifies a one- to six-digit decimal value in the range 0 to 

j 16770215 (or 2**-l) bytes, which indicates the number of bytes 

of storage to be provided from the CICS/OS/VS partition/region 
for the use of the operating system during CICS/OS/VS 
execution.* The minimum amount of storage available to the 
operating system is equal to the size of the system 
initialization program (DFHSIP)• The default is OSCOR=8192. 

If the value specified is greater than the size of DFHSIP, the 
amount of storage provided for the use of the operating system 
is equal to the size of DFHSIP plus the amount specified in 
excess of the size of DFHSIP* Note that this storage is not 
available to the operating system until DFHSIP transfers 
control to the dummy CSA program (DFHDCSA)• 

The user should be aware that an incorrect OSCOR specification 
could adversely affect system performance. The value specified 
should accurately reflect the amount of address space required 
by the operating system, depending upon the CICS/VS 
| configuration. If, for example, ACF/VTAM (VTAM3) is used, a 

| higher OSCOR value will be required. 

| The DL/I shared data base facility requires the following 

| amounts of storage which must be included in the OSCOR value 

| specifieds 

| ® For non-MVS systems, the value specified in the IRBUFSZ 

| operand of DFHTCT TYPE=INITIAL must be multiplied by the 

| number in the SESNUMB operand in DFHTCT TYPE=IRCBCH. For 

| MVS, the shared data base requirements (as stated above) 

j need not be in OSCOR, but the (MVS) CSA must be large 

| enough to provide the required storage. 

| • Approximately IRB + 12K bytes are required in the non-MVS 

| batch region (where IRB is the value in the IRB parameter 

I in the hatch region). Refer to the CICS/VS System 

I Programmers Guide (OS/VS)for a discussion on the batch 

j JCL for shared data base. For MVS, approximately 12K bytes 

j are required in the batch region and IRB + 72 bytes are 

f required in the (MVS) CSA- 


OSCOR is free address space within the CICS/VS region/partition 
which may be acquired by the host operating system (OS/VSl or 
OS/VS2) GETMAIN requests. CICS/VS itself, once initialized and 
running, does not issue host operating system GETMAINs, but 
directs all address space requests to the CICS/VS storage 
control program which satisfies those requests from a 
preallocated address space known as the CICS/VS dynamic storage 
pool. However, the host operating system or services of the 
host operating system used by CICS/VS may cause host operating 
system GETMAIN requests on behalf of CICS/VS. Some of the 
reasons for these storage requests are: 
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BDAM dynamically acquires IOBs and read-exclusive lists. 

The file control program, the transient data program, and 
the keypoint program all use BDAM* 

BDAM will acquire IOBs for each I/O request; therefore 
there will be as many IOBs and segments on the read- 
exclusive list as there are concurrent I/O requests. The 
number of concurrent BDAM I/O events would normally not 
exceed "Max Tasks". 

ISAM dynamically acquires IOBs for I/O requests. The file 
control program may use ISAM. 

ISAM will acquire IOBs for each I/O request, READ, READ 
UPDATE, or WRITE KN. However, READ UPDATE IOBs are saved 
and used for WRITE UPDATE requests before being released. 

VTAM will acquire storage from the CICS/VS partition in 
order to satisfy connection requests such as OPNDST, CLSDST 
and SIMLOGON. Requests are issued as a result of, for 
example, CONNECT=AUTO being specified in DFHTCT 
TYPE=TERMINAL, terminal logon, and the use of the master 
terminal ACQUIRE command. 

Use of dynamic OPEN/CLOSE in CICS/VS will significantly 
increase the amount of OSCOR used. OPEN requests may cause 
acquisition of the following areas: 


• IOBs 

• Channel programs 

• Buffers (extrapartition transient data) 

• Work areas (ISAM) 

• Additional control blocks as determined by the access 
methods used and the host operating system 

• Depending on the host operating system, access methods 
may also be loaded in OSCOR 

CLOSE requests may cause address space of the types 
acquired by OPEN requests to be released and made available 
as OSCOR. 

In addition to the size requirements of OSCOR, additional 
area should be allocated to allow for fragmentation which 
will result from intermixed host operating system GETMAIN 
and FREEMAIN requests of varying size. At least an 
additional 20 to 30 percent should be allowed in OSCOR 
estimates for fragmentation. 

For information concerning host operating system control 
block address space requirements, refer to the specific 
operating system reference manuals, such as the OS/VS1 
Storage Estimates manual. 


PDIR=suffix 

specifies a suffix for the PDIR list and is only applicable if 
the CICS/OS/VS-DL/I interface is to be used. The default is a 
blank suffix. 
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PISCHD=NOI YES 

indicates whether program isolation scheduling (PISCHD=YES) or 
segment intent scheduling (PISCHD=NO) is to be performed for 
transactions that access DL/I data bases. The PCT entry for 
transactions that use program isolation scheduling should 
include DTB=YES and, optionally, RESTART= YES so that a 
transaction that fails can be backed out dynamically and 
restarted automatically after such conditions as a transaction 
deadlock. The default is PISCHD=NO. Further details on 
program isolation scheduling can be found in the CICS/VS 
System/Application Design Guide . 


I PLISHRE-NOIYES 

specifies whether PL/I shared library support is to be 
included. The default is NO. 


PSB=name 

applicable only if the CICS/OS/VS-DL/I interface is to be used, 
this operand is used to specify the one- to eight-character 
name of the program specification block (PSB) used during 
IMS/VS initialization. This PSB contains a program 
communication block CPCB) for each DL/I access method to be 
used (two PCBs in the case of HISAM), and is used to load all 
required DL/I modules during initialization. The default is 
PSB=CICSPSB. 

The PSB operand is not applicable, and may be omitted, in the 
case where there are no data bases that are resident on the 
CICS/OS/VS system. This situation arises when all DL/I 
requests from the CICS/OS/VS system are for data bases that 
reside on remote CICS/OS/VS systems (and are accessed through 
the intersystem communication facility). 


PSBPL=number 

applicable only if the CICS/OS/VS-DL/I interface is to be used, 
this operand specifies the program specification block (PSB) 
pool size in 1024-byte blocks for CICS/VS-DL/I interface 
support. The number of 1024-byte blocks specified must be in 
the range 1 to 999. This operand corresponds to the PSB 
operand of the IMS/VS BUFPOOLS system generation macro 
instruction and to the III parameter of the IMS/VS CTL or CTX 
parameter list for online execution. The default is PSBPL=4. 


SRBSVC=number 

may be specified to change the SVC number that has been 
specified in the DFHSG TYPE=INITIAL macro. Refer to that macro 
for full details on the SRBSVC=number operand. 

Note : This operand only changes the SVC number that is used to 

pass control to the SVC code. It does not alter the name of 
the SVC routine itself (the name is derived from the SVC 
number). To alter the name of the SVC routine, a DFHSG 
TYPE=INITIAL,SRBSVC=number macro must be assembled, and the 
Stage 2 job that is produced must be run. 

The SRBSVC operand in DFHSIT makes CICS/OS/VS nucleus modules 
independent of the SVC nuraber- 
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SNT 


SIGN-ON TABLE 


The sign-on table provides a place for retaining terminal operator data 
permanently. It is accessed when a terminal operator initiates the 
sign-on procedure via the CSSN transaction. The sign-on table is the 
only table which cannot be suffixed. 

During the sign-on procedure, the name of the terminal operator is 
entered at the terminal and is used to locate the appropriate operator 
entry in the sign-on table. The operator entry in the table contains 
data used to verify the operator name and to establish a priority and a 
security key for the transactions which the operator subsequently 
| enters. The priority and security key values replace the values that 
j have already been specified or defaulted in the DFHTCT TYPE=TERMINAL 
| macro. 

The priority value assigned to the operator is used to develop the 
task priority for processing a transaction. The operator's security key 
is used in a security check of all transactions subsequently entered. 

The security key is matched with the transaction security value 
contained in the transaction's program control table (PCT) entry. 

If the operator security key contains any values that matches the 
| transaction security value in the PCT entry, the transaction is 

accepted. Otherwise, a security check occurs and the transaction is 
terminated. A security key of 1 is the default option in the creation 
of the sign-on table, the program control table, and the terminal 
control table. The security key default option allows transactions with 
a transaction security of 1 to be entered into the system by the 
operator without the sign-on procedure. 

The sign-on table macro instruction (DFHSNT) specifies the terminal 
operator data for the users of CICS/VS. A DFHSNT entry should be 
present in the sign-on table for each terminal operator who is expected 
to sign on. 

The sign-on table must be assembled, link-edited with the name 
DFHSNT, and represented in the processing program table (PPT). 


CONTROL SECTION — DFHSNT TYPE=INITIAL 


The control section into which the sign-on table is assembled is 
established by the DFHSNT TYPE-INITIAL macro instruction, which must be 
coded as the first statement in the source deck used to assemble the 
sign-on table. 

r - r - r - n 

j (DFHSNT j T YPE^INITIAL | 

L-L-L- J 


TYPE-INITIAL 

establishes the control section into which the sign-on table is 
assembled. 
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TERMINAL OPERATORS -- DFHSNT TYPE=ENTRY 


Each terminal operator is described to CICS/VS through entries in the 
sign-on table. These entries are made by issuing the DFHSNT TYPE=ENTRY 
macro instruction as follows: 


r 

" r " 1 " L ' 

“ l"“- 

" ” '"1 


j DFHSNT 

j TYPE=ENTRY 



i 

j ,OPIDENT=operator-identification 



i 

j ,0PNAME= * operator-name * 



i 

j ,PASSWRD=password 



i 

j [,NAMFORM=DEC] 



i 

| [ # 0PCLASS={1|(nl[,n2],...)}] 



i 

j f , OPPRTY= C 01number >] 


L- 

i 

-L- 

j t f SCTYKEY=tl|(nlt,n2],...)}] 



TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 


OPIDENT=operator-identification 

specifies the one- to three-character operator identification 
code assigned by the system administrator to each operator. 
This code is placed in the appropriate terminal control table 
terminal entry CTCTTE) when the operator signs on so that the 
identity of the operator is known to CICS/VS. This operator 
identification is made available to the master terminal when a 
security violation is detected. 


OPNAME= * operator-name* 

specifies the name of the terminal operator for this table 
entry. The operator name: 

• May be 1 to 20 characters long and must be unique for each 
entry 

• May not terminate with a blank 

• Must be matched exactly by the operator name entered in the 
sign-on procedure. The operator name may be enclosed 
within single quotes at sign-on. 

• May contain apostrophes. Two single quotes must be 
substituted for each apostrophe, and these will be 
translated by the assembler. 


PASSWRD=password 

specifies a four-character password (identification) created by 
the user. The password entered by a terminal operator as a 
part of the sign-on procedure must be matched exactly by the 
password in the operator’s sign-on table entry. Passwords may 
be unique to each operator or the same for a logical group of 
operators. 
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NAMFORM=DEC 

indicates that the sign-on data is expected from the operator 
ID reader of a 3741 terminal. It causes the data specified in 
the OPNAME parameter to be represented in hexadecimal format, 
with two characters per byte. The operator name will be padded 
to the right with X 1 FF 1 • 


OPCLASS=number 

specifies 1 to 24 decimal values in the range of 1 to 24. The 
default is OPCLASS^l. The operator class for a terminal 
operator is comprised of those values which match an internally 
initiated task request before the task will be initiated. Each 
decimal value specified in this operand has a corresponding bit 
position in a three-byte operator class field in the sign-on 
table entry which is placed in the TCTTE when the operator 
signs on to the corresponding terminal. The presence of each 
value in the operand causes the corresponding bit position to 
be set to 1. 

Note : The optional OPCLASS parameter in the DFHBMS TYPE=R0UTE 

macro is also specified as a single numeric value from 1 to 24. 
The corresponding value must be specified in the OPCLASS 
parameter of the DFHSNT macro before automatic routing will 
occur. 


OPPRTY=nuraber 

specifies a decimal operator priority value from 0 to 255. An 
operator priority is assigned optionally by the user and is 
used in developing the task processing priority for each 
transaction. The default is OPPRTY=0. 


SCTYKEY=number 

specifies one or more decimal security key values from 1 to 24. 
The default is SCTYKEY=1. The security key for a terminal 
operator is comprised of those values which are to be matched 
with the transaction security of an appropriate program control 
table entry. The security key may be built with from 1 to 24 
individual values. Each decimal value in the range 1 to 24 
specified in the operand of the SCTYKEY keyword has a 
corresponding bit position in a three-byte SCTYKEY field. The 
presence of each value in the operand causes the corresponding 
relative bit position to be set on. 

The transaction security defined by the TRANSEC operand in a 
program control table is specified as only one of the possible 
24 individual values. The same value must be contained in the 
operator 1 s security key to allow the operator to process that 
transaction. The operator's security key is not limited to 
just one value and may contain several values. 


END OF SIGN-ON TABLE — DFHSNT TYPE-FINAL 


The end of the sign-on table is indicated by the DFHSNT TYPE=FINAL macro 
instruction, which is the last statement in the assembly of the sign-on 
table before the assembler END statement. This macro instruction 
creates a dummy entry to signal the end of the table. 
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[ (DFHSNT [ TYPE=FINAL 

L-L--L—-- 


I 

J 


TYPE=FINAL 

indicates the end of the sign-on table. 


EXAMPLE 


| Figure 3.2-13 contains an example of coding for the sign-on table. In 
this example, there are two cases where the operator names are actual 
names and one instance of the name being a function. The first operator 
has access to transactions whose transaction securities are 1, 2, 7 f or 
24. The other two operators have access to the same transactions as the 
first plus additional transactions. The second operator has a default 
priority of zero. 


DFHSNT TYPE=INITIAL 

DFHSNT TYPE=ENTRY, * 

OPNAME= 1 DON GIBSON*, * 

PASSWRD=DIST, * 

OPIDENT=DG, * 

SCTYKEY=(1,2,7,24), * 

OPPRTY=128 

DFHSNT TYPE=ENTRY, * 

OPNAME='R. J. JONES*, * 

PASSWRD=DIST, * 

OPIDENT=RJJ, * 

SCTYKEY=(1,2,7,9,24) 

DFHSNT TYPE=ENTRY, * 

OPNAME-*MASTER TERMINAL 1*, * 

PASSWRD=MAST, * 

0PIDENT=MT1, * 

SCTYKEY=(1,2,3,4,7,9,24), * 

OPPRTY=255 

DFHSNT TYPE=FINAL 
| END 


| Figure 3.2-13. Sign-On Table - Example 


SRT — SYSTEM RECOVERY TABLE 


The system recovery table contains a list of abend codes that will be 
intercepted. It also contains the identification of logic to be 
executed in the form of either a user- or a CICS/VS-supplied routine. 

| The following macro instructions may be specified in a system 
j recovery tables 

| • DFHSRT TYPE=INITIAL - to establish the control section 

| • DFHSRT TYPE=SYSTEM|USER - to specify the abend codes that are to be 

j handled 

| • DFHSRT TYPE=FINAL - to conclude the system recovery table. 
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CONTROL SECTION 


DFHSRT TYPE=INITIAL 


The DFHSRT TYPE=INITIAL macro instruction generates the system recovery 
table control section. 


r - r - r - 

| |DFHSRT j TYPE=INITIAL 

| | | [,SUFFIX=xxl 

L-t-L- 


I 

I 


J 


TYPE=INITIAL 

establishes the control section into which the system recovery 
table is assembled. 


SUFFIX=xx 

is a one- or two-character alphameric suffix for the module 
being assembled. This suffix, if present, is appended to the 
standard module name (DFHSRT) which is used to name the module 
on the linkage editor output library. 


ABEND CODES — DFHSRT TYPE=SYSTEM|USER 

The DFHSRT TYPE=SYSTEM]USER macro instruction is used to specify abend 
codes in the system recovery table. 


r r r 

| |DFHSRT | TYPE={SYSTEM|USER} 

| j j ,ABCODE=(abend-code,,,,) 

j j j (,PROGRAM=program-name]|[,ROUTINE=name] 

L—-L-L- 


1 


i 

J 


| TYPE= SYSTEM | USER 

indicates the type of abend code to be intercepted. The 
default is TYPE=SYSTEM. 

SYSTEM 

identifies the abend code as an operating system abend 
code. 

USER 

identifies the abend code as a user (including CICS/VS) 
abend code. This option applies to CICS/OS/VS only. 


ABCODE=abend-code 

identifies the abend code (or codes) to be handled by the 
routine identified by this macro definition. DOS/VS codes are 
contained in DOS/VS Supervisor and I/O Macros in the discussion 
of the STXIT macro instruction. For example, code 30 indicates 
an abend because an attempt was made to read beyond a /$ 
statement. 


PROGRAM= program- name 

identifies the program name to be given control when this abend 
is encountered. The name specified by this parameter must be 
in the PPT. 
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ROUTINE=name 

identifies the resident routine to be given control when the 
abend is encountered. A routine is either a separately linked 
module or a routine coded in line in the SRT. If it is a 
separately linked module, its name need not be in the PPT since 
a V-Type ADCON is set up in the SRT. If it is coded in line, 
the routine must be placed after the DFHSRT TYPE=FINAL 
statement. The name specified must appear in either a CSECT or 
ENTRY statement in the routine. 


Notes ; 

1. PROGRAM and ROUTINE are mutually exclusive. 

2. A routine is supplied and generated in the system recovery table 
which intercepts selected system abend codes (shown in the 
following lists) and attempts to keep CICS/VS operational by 
disabling a resource and/or causing the offending task to abend. 

If the user wishes to supply his own routine for these abend codes 
or not to attempt recovery, he may so indicate by coding a DFHSRT 
macro for those abend codes. If an abend code or a group of abend 
codes is specified without the PROGRAM or ROUTINE parameters, no 
recovery will be attempted should one of those codes occur, and 
CICS/VS will be terminated. 

The following OS/VS abend codes will be intercepted and recovery 
will be attempted under the CICS/VS-supplied recovery routine: 


001,002,013,020,025,026,030, 

032,033,034,035 f 036,037 f 03A, 

03B,03D,100,113,117,213,214, 

237,313,314,337,400,413,437, 

513,514,613,614,637,713,714, 

737,80A,813,837,913,A13,A14, 

B13,B14,B37,D23,D37,E37 

In addition, with OS/VS2 Release 2 or later, abend code 0F3 will be 
intercepted and recovery attempted, abend code OF3 covers various 
machine check conditions. It also covers the Alternate Processor 
Retry (ACR) condition which can only occur when running on a 
multiprocessor. CICS/VS-supplied recovery code (generated for 
OS/VS2 Release 2 or later) will attempt to recover from 
instruction-failure machine checks on the assumption that they are 
not permanent. It will also attempt to recover from ACR 
conditions. 

The following DOS/VS abend codes will be intercepted and recovery 
will be attempted under the CICS/VS-supplied recovery routine: 


13,1A,1B,21,22,25,26,27,2B, 

30,32,33 

To obtain recovery for the abend codes above, the DFHSRT macro 
instruction can be specified as follows: 


DFHSRT TYPE-INITIAL 
DFHSRT TYPE=FINAL 

3. If the user wishes to have the CICS/VS-supplied routine handle 

other errors, he can code the DFHSRT macro instruction as follows: 
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DFHSRT TYPE=SYSTEM , or USER, 

ABCODE=(user or system codes), 

ROUTINE=DFHSRTRR 

4. Abend recovery is based on CICS/VS-supplied functions; therefore, 
users should be aware that modifications to CICS/VS-supplied 
programs and nucleus modules, or operating system macros issued by 
application programs capable of causing an abend, will not be 
recovered by CICS/VS. For these cases, additional logic should be 
added to the recovery routine or a user-supplied routine should be 
provided. 


END OF SYSTEM RECOVERY TABLE — DFHSRT TYPE=FINAL 


The macro instruction used to specify the end of the system recovery 
table is: 

\ [DFHSRT \ TYPE=FINAL 

L -L-L---—- 




I 

J 


TYPE=FINAL 

indicates the end of the system recovery table. Any inline 
routines and the assembler END statement must follow this 
statement. 

For information concerning the creation of the PROGRAM or ROUTINE to 
handle abends in connection with the system recovery table, see 
"Creating a System or User Abend Exit" in Chapter 4.5 of this manual. 


EXAMPLE 


| Figure 3.2-14 illustrates the coding required to generate a system 
recovery table. 


DFHSRT TYPE=INITIAL, * 

SUFFIX=K1 

DFHSRT TYPE=SYSTEM, * 

ABCODE=777, * 

ROUTINE=RETURN 

DFHSRT TYPE=USER, * 

ABCODE=(888, 999) , * 

ROUTINE=RETURN 

DFHSRT TYPE=USER, * 

ABCODE=020 

DFHSRT TYPE=FINAL 
| END 


| Figure 3.2-14. System Recovery Table - Example 
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| TCT — TERMINAL CONTROL TABLE 


The terminal control table macro instruction (DFHTCT) is used to specify 
the user's CICS/VS terminal environment, which can include 
telecommunication devices, sequential processing devices, graphic 
| devices, and inter-system and inter-region links. 

| The DFHTCT macros may be generated in any order, except where 
| indicated in the list of macro instructions that follows. The 
| individual macros within the terminal control table are presented in 
j alphabetic order, with the exception of TYPE=INITIAL and TYPE=FINAL, in 
j the following manner: 


DFHTCT TYPE-INITIAL 

DFHTCT TYPE=GPENTRY - to describe a group of terminals 

under CICS/DOS/VS 


DFHTCT TYPE=IRCBCH 

DFHTCT TYPE=ISLINK 

DFHTCT TYPE=LDC 
DFHTCT TYPE=LDCLIST - 
DFHTCT TYPE-LINE 

DFHTCT TYPE=SDSCI 
DFHTCT TYPE=TERMINAL - 
DFHTCT TYPE=TLXID 
DFHTCT TYPE=TLXMSG 

DFHTCT TYPE=7770MSG - 
DFHTCT TYPE=FINAL 


to describe a shared data base link to 
batch regions under CICS/OS/VS 

to define the intersystem communication 
link between one CICS/VS system and another 

to generate logical device codes 

to generate lists of logical device codes 

to describe the characteristics of a line. 

The TYPE=LINE macro must be generated before 
the related TYPE=TERMINAL macro. 

to describe data set control information 

to describe the types of terminals on the line 

to define the Teletypewriter (WTC only) station 

to define the Teletypewriter (WTC only) 
disconnect messages 

to define digital response messages for the 7770 


CONFIGURATOR 

This section is intended to aid the system programmer in the preparation 
of the terminal control table (TCT) as he uses operands of the DFHTCT 
macro instruction to: 

1. Describe terminal types for VTAM and non-VTAM access methods. 

2. Describe communication lines. 

3. Specify data set control information. 

Included in this section is an indication of whether the operands of 
the DFHTCT macro instruction are: 
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1. Optional or required 


2. Applicable only to CICS/DOS/VS, CICS/OS/VS, or to both CICS/DOS/VS 
and CICS/OS/VS. 

3. Applicable or required only under special circumstances. 

VTAM and TCAM SNA Terminal Types (DFHTCT TYPE=TERMINAL) 
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R Required O Optional 

* It is recommended that a high OPERSEC be used as a means 
to limit access to authorized users. 

1. Supported by VTAM only 

2. Required by VTAM only 

3. Required by TCAM for BMS support 
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Non-VTAM Terminal Types (DFHTCT TYPE=TERMINAL) 
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R Required 

0 Optional 

* CICS/DOS/VS only 

# CICS/OS/VS only 

1 Required only for local devices. 

2 Required only for remote devices? specify hexadecimal 
addressing characters. 

3 Required? specify hexadecimal addressing characters, in 
the appropriate terminal transmission code, nonswitched 
lines? specify name of DFTRMLST for switched lines. 
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(For TWX, not required if ANSWRBK=TERMINAL is specified*) 


4 Required for multipoint lines and for switched lines if 
FEATURE=AUTOCALL has been specified in the DFHTCT TYPE=LINE 
macro instruction; specify name of DFTRMLST. 

5 Required for component polling; defaults to polling all 
components. 

6 Required for the 2740 Model 2. 

7 Required for terminals when the user defines a 0-255 byte 
terminal work area (process control information field). 

8 Required for a 3275 on a leased line, not used for a 
dial 3275. 

9 Optional; TRMIDNT=CNSL is default. 

10 Optional; RECEIVE is default. 
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R Required 
O Optional 

* CICS/DOS/VS only 

# CICS/OS/VS only 

1 Not required; SYSLOG is forced• 

2 Not required; CONSOLE is forced• 


Communication Lines (DFHTCT TYPE=LINE) 
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R Required 
O Optional 

# CICS/OS/VS only 

♦ TRMMODL may be specified in TYPE=LINE or TYPE=TERMINAL. 
♦* CICS/DOS/VS only 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 


Required if a terminal work area (PCI) field is to be 
defined for all terminal entries associated with this line. 
Specify ACCMETH= SAM, ACCMETH=BSAM, or ACCMETH= SEQUENTIAL• 
Maximum value of 80* 

Specify ACCMETH= BTAM or ACCMETH= TCAM. 

Required for switched (dial-up) lines and multipoint lines. 
Required if FEATURE=(AUTOANSR or SCONTROL). 

Required for first line in switched-line pool; specify 
ANSWRBK=EXIDVER for 3735 under CICS/OS/VS and CICS/DOS/VS. 
Checking required; other features optional. 

Required for component polling; default: poll all components. 
Required for the 2740 Model 2. 

Specify ACCMETH=TCAM. 


CONTROL SECTION — DFHTCT TYPE=INITIAL 


The area of storage into which the terminal control table is assembled 
is established in response to the DFHTCT TYPE=INITIAL macro instruction, 
which must precede all other DFHTCT macro instructions in a terminal 
control table assembly. 

The format of the macro instruction used to establish the control 
section for the terminal control table is as follows. Note that the 
optional operands which apply only to logical units are listed 
separately in the syntax display, and are in alphabetic order in the 
description of the operands which follows. 


r- 

I 

1 

1 1 

1 

I 

IDFHTCT 

1 

1 

1 

1 

1 TYPE=INITIAL 

1 t . ACCMETH=(NONVTAM.VTAM) 1 

1 [,APPLID= { name 1 DBDCCICS } ] 

| [,SUFFIX=xxl 

1 

- - 1 

l 

1 

1 

1 

1 

1 

1 VTAM only 
j 


I 

1 1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 l .GMTEXT= Cwelcome-to-CICS/VS 1' text* }] 
j t,OPNDLIM=number 3 
j t,RAMAX=value] 
j t,RAMIN=C0lvalue}] 
j [ ,RAPOOL=t2 | value }] 
j t,RATIMES={2 lvalue}] 

| t,RESP={FME|RRN}] 
j 


1 

1 

1 

I 

1 

1 

1 DOS/VS only 


1 

1 

| 

1 

1 

f 

1 

1 (,MODNAME={IJLBTMlname] ] 
j 


1 

1 

1 

1 

t 

1 OS/VS Only 

1 


1 1 

1 

1 

- t - 

| [,IRBUFSZ=length] 

---J 


TYPE=INITIAL 

establishes the control section into which the terminal control 
table is assembled. 
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| ACCMETH -NONVTAM |VTAM 

controls the building of the access-method-dependent portions 
of the TCT. If both NONVTAM and VTAM are specified, the TCT is 
built for all access methods. The default is NONVTAM. 

NONVTAM 

Virtual Telecommunications Access Method portion is not 
generated. 

VTAM 

Virtual Telecommunications Access Method portion is 
generated. 


APPLID=name 

| specifies a one- to eight-character application name defined to 

VTAM during VTAM system definition. This identifies CICS/VS to 
VTAM as an application program and may be overridden at CICS/VS 
system initialization by the DFHSIT APPLID=name parameter. 

| APPLID=name may also be used in this macro to provide the name 

I for a CICS/VS system that is communicating with another CICS/VS 

| system or with the batch region during a DL/I shared data base 

I session under CICS/OS/VS. APPLID=name will default to DBDCCICS 

J if omitted. 


| GMTEXT =we1come-to-CICS/VS 1 * text * 

| indicates whether the default "good morning" sign-on message 

j ("welcome to CICS/VS") or a user-supplied sign-on message is to 

j appear for each terminal entry when the terminal is signed on 

| to VTAM. The appropriate sign-on message may be specified for 

i indididual terminal entries through the GMMSG operand in DFHTCT 

| TYPE=TERMINAL. 


OPNDLIM=number 

indicates the open destination/close destination request limit. 
This limit is used to restrict the number of concurrent OPNDSTs 
or CLSDSTs to prevent VTAM from running out of space in the 
CICS/VS region. The default value is 10. When large values 
are used for OPNDLIM, the value of OSCOR in DFHSIT (OS/VS only) 
may need to be adjusted. 


RAMAX=value 

indicates the size in bytes of the I/O area allocated for each 
RECEIVE ANY issued by CICS/VS. The maximum value is 65515. 


RAMIN=value 

indicates the data length size below which RECEIVE ANY input is 
transferred from the RECEIVE ANY I/O area to a new TIOA. The 
length of the new TIOA is the greater of the data length or 
TIOAL. The maximum value is the value of RAMAX. If this 
operand is not specified the default is zero. 


RAPOOL=value 

specifies the number of fixed RPLs that are generated in the 
TCT prefix. When not at MAXTASK, CICS/VS maintains a RECEIVE 
ANY for each of these RPLs. The number of RPLs required is 
dependent on the expected activity of the system, the average 
transaction lifetime, and the MAXTASK specified. The default 
value is 2. 
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RATIMES=value 

specifies the multiplier used to establish the maximum 
allowable initial input message length. If the data exceeds 
the RAMAX I/O area, a new area up to a maximum size of RAMAX x 
RATIMES is allocated. If the data exceeds this length, a 
negative response is returned to the logical unit. This 
operand is optional and defaults to a value of 2. 

Note : This operand is not used with VTAM-supported 3270s, 

because the maximum allowable input from a 3270 equals a buffer 
size, whatever the value of RATIMES. 


| RESP=response-type 

specifies the type of response CICS/VS is to request when 
transmitting data to a logical unit. FME is the default and is 
the normal type of response. 

FME 

indicates that a function management end (FME) response is 
to be requested. This is equivalent to specifying a 
definite response type 1 (DR1)• 

Note : This option is not used with VTAM-supported 3270s, 

because FME is always requested. 

RRN 

indicates that a reached recovery node (RRN) response is to 
be requested. This is equivalent to specifying a definite 
response type 2 (DR2). 


SUFFIX=xx 

specifies a one- or two-character alphameric suffix for the 
terminal control table being assembled. This suffix, if 
specified, is appended to the standard module name (DFHTCT) and 
is used to name the module on the linkage editor output 
library. If this operand is omitted, a suffix is not provided. 


For DOS/VS only 


MODNAME=n ame1 IJLBTM 

specifies the BTAM modules to be requested by name. The 
default is MODNAME=IJLBTM. 


name 

specifies the BTAM module name. 

IJLBTM 

indicates the system default name if MODNAME=name is not 
specified. 

Note : BTAM modules and names must be assembled and cataloged 

as described in the CICS/VS System Programmers Guide (DOS/VS) . 
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For OS/VS only 


IRBUFSZ=length 

indicates the maximum length of data sent to CICS/VS for a 
batch request during a DL/I shared data base session under 
CICS/OS/VS. The value for IRBUFSZ should be calculated using 
the following information: 

• The inter-region buffer contains a single DL/I request. 

For an input request the buffer contains: 

control information (approximately 40 bytes) 

the SSAs specified on the request. (Each SSA occupies 
"SSA" bytes, where "SSA" is the value of the SSA 
parameter on the sharing batch PARM Field.) 

• For an output request, the buffer contains the same as for 
the input, plus: 

The DL/I I/O area; the I/O area is assumed to occupy 
the maximum size that an I/O area can occupy for the 
scheduled PSB. Thus, sharing batch programs should not 
use PSBs that allow "path" access unless they are 
actually using that type of access. 

The IRBUFSZ value should be large enough to contain the largest 
buffer needed. The maximum value for IRBUFSZ is 65500 bytes. 


LINE GROUP TYPES — DFHTCT TYPE=GPENTRY 


Available for CICS/DOS/VS only, the DFHTCT TYPE=GPENTRY macro 
instruction may be used with the following device types in a non-VTAM 
environment: 

• Local 3270 

• Remote 3270 

• Multipoint 2740 

• Point-to-point 2740/2741 

• Dial-up 2740/2741 

• Processing unit console operating as a terminal 

• Sequential devices used to simulate terminals 

The DFHTCT TYPE=GPENTRY macro allows the system programmer to specify 
terminal types and device characteristics on a line group basis, and may 
be used instead of indicating the desired features in the DFHTCT 
TYPE=SDSCI, LINE, and TERMINAL macro instructions. 

The options in each operand of this macro are positional; for 
example, LINFEAT=(0,B,,B) indicates that the first terminal in this line 
group has open polling, the second terminal has the buffered receive 
feature, and the fourth also has the buffered receive feature. 
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TYPE=G PENTRY 
,GPTYPE=type 

[,ALTSCRN= (lines, columns) (,...33 
(,CUADDR=(nn3 
[,CUFEAT=(feature[,...3,.. .33 
[,CUPOSN=(nnt,...3,...> 3 
(,GPBLKSZ=(nnnnn(,...3,...)3 
[,GPNAME=(INnarae,OUTname) 
[,GPNTRMS=(nn(,..3,..)) 
t,GPSEQLU=(nnn(, 

(,GPTCU={2701|2702|2703|ICA33 
(,LINELST=(nnn(,...3,...)3 
t,LINFEAT=(featurel,.. . 3 , . . .) 3 
I ,LININL=(number[, . . . 3 , . . . ) 3 
(,TRMADDR=(nnl,..3,..)3 
[,TRMFEAT=(A,D,S,U,P,T)3 

(,TRMIDNT=(xxxxt,-3 ,-)3 

(,TRMINL=(number)3 

(,TRMMODL=(number,character),(...,...33 

(,TRMPOSN=(nn[,..3,..)3 

l,TRMPRTY=(number f,...3,...)3 

[ , TRMSTAT=(T,I, A, X, R) 3 

t,TRMUAL=(number E, 3, >3 


TYPE=GPENTRY 

indicates that a terminal line group entry is to be made. 


GPTYPE=type 

specifies the type of terminal in the line group. One type 
option may be specified in each DFHTCT TYPE=GPENTRY macro. The 
options are: 

• 3270L - Local 3270 

• 327OR - Remote 3270. The suffixes A (ASCII support) or E 
(EBCDIC support) may be appended. 

• 2740S - Multipoint 2740 with the station control feature. 

The following suffixes may be appended: 

C - for the VRC/LRC checking feature 

A - for the start/stop autopoll feature. This option cannot 
be used for lines attached to a 2701. 

CA - for both these features. 

• 2740 - Point-to-point 2740/2741. The options are: 

2740 - 2740 model 1 without the VRC/LRC checking feature 
2740C - 2740 model 1 with the VRC/LRC checking feature 
2741C - 2741 with correspondence code 
274IE - 2741 with PTTC/EBCD transmission code 


238 


CICS/VS System Programmer's Reference Manual 








| • 274OD - Dial-up 2740/2741. The options are: 

| 274OD - 2740 model 1 without VRC/LRC checking 

| 2740DC - 2740 model 1 with VRC/LRC checking 

| 2741DC - 2741 with correspondence code 

| 2741DE - 2741 with PTTC/EBCD transmission code 

j • CONSOLE - Processing unit console 

| • (Input,Output) - Sequential devices used to simulate a 

| terminal. The options are: 

| For tape: (TAPE,TAPE) 

| For DASD: ({3330|3340|3350},{3330|3340|3350} 

| For unit record devices: 

| input: 1442,2501,2520,2540,3505,3525, or 2596 

j output: 1403,1404,3203,5203,1443,1445, or 3211 


ALTSCRN=(lines,columns) 

defines the 3270 screen size to be used for a transaction that 
has SCRNSZE=ALTERNATE specified in DFHPCT TYPE=ENTRY. The 
default is the value specified in the TRMMODL operand. The 
values that can be specified are: 


3276-1,3278-1 (12,80) 
3276-2,3278-2 (24,80) 
3276-3,3278-3 (32,80) 
3276-4,3278-4 (43,80) 


Note that there is no validity checking performed on the screen 
size selected, and that incorrect sizes may lead to 
unpredictable results. 


CUADDR^nn 

applies to 327OR only, and indicates the control unit address 
for each remote control unit in the line group. The range is 0 
through 31. 


CUFEAT=feature 

applies to 327OR only, and specifies the features associated 
with the control unit. "C" indicates the COPY feature. 


CUPOSN=nn 

applies to 327OR only, and indicates the relative position of 
the line in the LINELST operand (1 through 31) to which each 
control unit is attached. The range is 1 through 40. 


GPBLKS Z =nnnnn 

applies to sequential devices only, and specifies the block 
size of the input and output files. The range is 20 through 
32000. For unit record devices, the block size specified must 
be the same as the device buffer size. 
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GPNAME=(iNname,OUTnameD 

applies only to DASD sequential devices, and specifies the 
input and output DOS/VS file names for DASD files* The name 
specified must be the same as in the DLBL job control 
statements. 


GPNTRMS=nn 

applies to 2740/2741 dial-up terminals only, and specifies the 
number of terminals in the line group. The range is 1 through 
40. 


GPSEQLU=nnn 

applies to sequential devices (except DASD) only, and specifies 
the system logical unit number to be assigned to the input and 
output files. IPT and LST may be specified for unit record 
devices. 


GPTCU= control-unit 

applies to 3270R, multipoint 2740, 2740/2741 point-to point, 
and 2740/2741 dial-up terminals, and specifies the transmission 
control unit attached to the processor. The options are: 2701, 
2702, 2703, and ICA. 270x must be specified when the 270x 
control unit is being emulated by a 37Ox. 2701 may not be 
specified for 2741 point-to-point and dial-up terminals. 


LINELST=nnn 

is available for all group types except sequential and console 
devices, and specifies the system logical unit number assigned 
to each terminal in the line group. A maximum of 31 lines may 
be defined in this list. 


LINFEAT=feature 

applies to 3270R and multipoint 2740 terminals only, and 
specifies the line features. Wrap-around polling is implied; 
O indicates open polling, and B (2740 only) indicates the 
buffered receive feature. 


LININL=number 

applies to 3270L, all 2740/2741 terminals, and sequential 
devices, and specifies the terminal input area length. The 
number specified should be large enough to handle 80% of the 
input messages. 

For 2740 model 2 multipoint devices, the maximum length is the 
buffer size minus 2. CICS/VS truncates messages longer than 
this length. 

For sequential devices, the value in LININL must be greater 
than that in GPBLKSZ if the application program will reuse the 
same message area for output. 


TRMADDR=nn 

applies to 3270R and 2740 multipoint terminals, and specifies 
the address of each terminal in the line group. The range is 0 
through 31 for 3270R, and A-Z, 0-9, and & for 2740s. 
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TRMFEAT=feature 

applies to 3270L, 3270R, 2740/2741 point-to-point, and 2741 
dial-up terminals, and indicates the features for each terminal 
in the line group. 3270 displays may have a combination of A # 
D, S, and U. The options are: 


•A - audible alarm feature 

• D - dual case keyboard 

• S - selector pen feature 

• U - upper case translate 

• P - printer (required for 3270 printers). CUFEAT 

must be specified with C f and the 3270 control unit must 
have the COPY feature. 

• T - 2740/2741 text mode (lower-case letters are to be 

preserved in input messages). 


TRMIDNT=xxxx 

specifies a four-character terminal identification for each 
terminal in the line group. CNSL must be specified for 
processing unit console support. 


TRMINL=number 

applies to 327OR only, and specifies a terminal input area 
length that is large enough to handle 80% of input messages. 
If the number specified is too small, CICS/VS issues GETMAIN 
macros to obtain additional storage. Too large a number will 
increase the DOS/VS working set and will degrade the system. 
TRMINL=0 must be specified for printer input areas. 


TRMMODL=(number,character) 

applies to 3270L, 3270R, and multipoint 2740 terminals, and 
indicates the model number of each terminal in the line group. 
The options are: 


Device 

Buffer size 

Model number 

3277 

480 

1A 


1920 

2A 

3284 

480 

IB 


1920 

2B 

3286 

480 

1C 


1920 

2C 

3275R 

480 

ID 


1920 

2D 

3275 + printer 

480 

IE 


1920 

2E 

2740 model 1 


1 

2740 model 2 

120 

1A 


248 

2B 


440 

2C 


For other devices, the model number is used to define the 
default screen size. Thus, for other 3270 displays, 1A or 2A 
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should be used, depending on the buffer size. For other 3270 
printers, IB or 2B should be used. 


TRMPOSN=nn 

applies to 3270R and 2740 multipoint devices, and indicates the 
relative position of the control unit (CUPOSN= 1 through 40 for 
3270R) or of the line (LINELST=1 through 31 for 2740) to which 
each terminal is attached. In both cases, a maximum of 40 
terminals may be defined. 


TRMPRTY=number 

is valid for all device types except sequential devices, and 
indicates the priority assigned to each terminal in the line 
group. The task processing priority is equal to the sum of the 
terminal, operator, and transaction priorities. The sum must 
not exceed 255. 


TRMSTAT=status 

applies to 2740 multipoint, 2740/2741 point-to-point, 2741 
dial-up, and sequential devices, and indicates the status of 
each terminal in the line group. The options are: 


• T - transaction status 
•I - input status 

•A - transceive status 

• X - out of service 

• R - terminal is being used as a printer and may not be used 

to enter data 


TRMUAL=number 

is available for all device types and indicates, for each 
terminal in the line group, the size of the terminal control 
table user area if this area is used by application programs. 
Any information stored in this area is available to all 
transactions originated by this terminal. The maximum TRMUAL 
size is 255 bytes; the default is 0. 


COMMUNICATE WITH BATCH REGIONS — DFHTCT TYPE=IRCBCH 


The DFHTCT TYPE=IRCBCH macro instruction defines the link between the 
CICS/OS/VS system and the batch systems that wish to share DL/I data 
bases with CICS/VS. 


r - r r 
| |DFHTCT j TYPE=IRCBCH 

| | | ,SESNUMB=number 

L-L-L—-- 


*1 

I 


J 


TYPE=IRCBCH 

indicates that a DL/I shared data base session is to be 
initiated under CICS/OS/VS. 
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SESNUMB=number 

indicates the maximum number of batch regions that can 
concurrently share DL/I data bases when in session with 
CICS/OS/VS. Note that the number of DL/I threads (specified in 
the DLTHRED operand of DFHSIT) may need to be increased to 
accommodate the value specified in SESNUMB. 


INTERSYSTEM COMMUNICATION LINKS — DFHTCT TYPE=ISLINK 


The DFHTCT TYPE=ISLINK macro instruction for VTAM only, generates the 
CICS/VS control blocks that are required when defining one CICS/VS 
system to another for an intersystem communication session. The macro 
generates a system entry (TCTSE) which defines the intersystem link, and 
a terminal entry (TCTTE). The following syntax display shows the TCTTE 
operands that can be used for an intersystem link. 



TYPE=ISLINK 
, ACCMETH=VTAM 
, S YSI DNT= name 
(,NETNAME=name] 

(,TRMSTAT=" OUT OF SERVICE"] 

TCTTE operands 

,LASTTRM=VTAM 
,TRMIDNT=name 
(,BUFFER=buffer size] 

[,CHNASSY—YES] 

[,C0NNECT=AUT03 
[,OPERID=id] 

C,OPERPRI=numberl 
(,OPERSEC=security key] 
t,RELREQ={(NO,. . . ) |(YES,...)| (... 
(,RUSIZE=sizel 
(,SESTYPE={SEND|RECEIVE}] 

C,TCTUAL=number] 

[,TIOAL=(value(value-1,value-2))] 
C,TRMPRTY=number] 


,NO) | («.'•, YES) }] 


label 

is optional and may be used to indicate a one- to eight- 
character name that identifies the DFHTCT TYPE=ISLINK macro 
being generated. 


TYPE=ISLINK 

indicates that an intersystem communication link is to be 
defined. 


ACCMETH= VTAM 

indicates that the intersystem communication link is to use the 
Virtual Telecommunications Access Method. 


LASTTRM=VTAM 

indicates that this is the last entry in a VTAM group of TCTTEs 
and intersystem communication links. 
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SYSIDNT=name 

provides a one- to four-character alphanumeric name to identify 
the intersystem communication link* This name must also be 
specified in the SYSIDNT=name operand in DFHDCT TYPE=REMOTE, 
DFHFCT TYPE=REMOTE, DFHPCT TYPE=ENTRY for a remote entry, or 
DFHTST TYPE=REMOTE unless the name is specified in an explicit 
remote request by an application program. More than one VTAM 
intersystem link may be defined, each known locally by a 
different SYSIDNT name, but with the same NETNAME. If the 
NETNAME operand is omitted, SYSIDNT=name must satisfy the 
requirements that apply to NETNAME. 


TRMIDNT=name 

indicates the four-character name by which this TCTTE will be 
known in the local system. 


NETNAME=name 

provides a unique one- to eight-character alphanumeric network 
name that identifies the remote CICS/VS system, and is the same 
name as that specified in the APPLID=name operand of DFHTCT 
TYPE=INITIAL in the remote system. The default for NETNAME is 
the name specified in the SYSIDNT operand. 


TRMSTAT-*OUT OF SERVICE" 

indicates that the intersystem link is to be initiated with an 
"out of service" status. This operand defaults to "in service" 
status. 


SESTYPE= SEND|RECEIVE 

In the contents of an intersystem communication session, the 
SESTYPE operand may include the SEND option to indicate that 
most intersystem requests will originate from this (local) 
system, or the RECEIVE option to indicate that most requests 
will originate from the remote system. If SESTYPE= SEND is 
specified for the local system, SESTYPE=RECEIVE should be 
indicated for the remote system, and vice versa. 

The remaining TCTTE operands (listed in the syntax display) are as 
described in the DFHTCT TYPE=TERMINAL macro. Note that the value 
specified in the RUSIZE operand in one system must be the same as that 
in the BUFFER operand for the other system. 


SYSTEM LDC TABLE AND EXTENDED LOCAL LDC LIST — DFHTCT 
TYPE=LDC 


The DFHTCT TYPE=LDC macro instruction generates the system LDC table and 
allows the system programmer to: 

• Request a set of default logical device codes (LDCs) and parameters 

J for the 3601, the 3770 batch logical unit, or the 3770/3790 batch 

data interchange logical unit being defined. 

• Establish the page size and page status for logical units 
associated with a terminal. 

• Specify an LDC for a BMS operation. 
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• override the system LDC table by an extended local LDC list, 

generated by the LOCAL=INITIAL and PINAL operand, which enables LDC 
mnemonics to be used in an application program to refer to 
different device types* 

Logical device codes are used to identify a device that is attached 
to a logical unit* The device does not communicate directly with 
CICS/VS, but through the logical unit* Fbr example, a card punch device 
may be attached to a 3770 logical unit: the CICS/VS application program 
can direct punch output, through BMS, via the 3770 to the card punch 
device* 

For further information on LDCs, refer to the appropriate CICS/VS 
subsystem guide. 

When an output operation is requested using a particular LDC, 
resolution of the mnemonic is attempted from the list referenced by the 
LDC operand of the DFHTCT TYPE=TERMINAL macro. This list can be a local 
list specified in the LDC operand of the DFHTCT TYPE=TERMINAL macro, or 
specified by the DFHTCT TYPE=LDCLIST macro, which is pointed to by the 
LDC operand. 

Alternatively, it can be an extended local LDC list, generated by a 
set of DFHTCT TYPE=LDC macros. The extended local LDC list allows the 
system LDC table device characteristics to be overridden. If the LDC is 
not located in the local list or in the extended local list, the LDC 
specified is not valid for that terminal entry. In this case, X*00* is 
inserted in the logical device code portion of the FMH, and no 
destination name is inserted. 

When a BMS function is requested for an LDC, resolution of the 
mnemonic is attempted as above. If successful, the device 
characteristics (for example, device name and destination name) are 
accessed. If the local list is extended, these characteristics lie 
within the located local list entry. If it is not extended, the system 
LDC table is searched for the LDC and the associated device 
characteristics. 

Note : This macro instruction is only required if there are 3600 or 

batch logical units defined in the TCT. 


r -* r 

|[name]|DFHTCT 

r' 

1 

TYPE=LDC 

-~ - 1 

1 1 

1 

t,DSN=destination-name] 


1 1 

1 

l ,DVC=device-type3 


1 1 

1 

[,LDC={SYSTEM136001BCHLUI(aat=nnn3) >3 


1 1 

1 

[,LOCAL=INITIAL|FINAL] 


1 I 

1 

£ ,PGESIZE=(row,column)) 


1 i 

I 

(,PGESTAT= CAUTOPAGEI PAGE)] 

- _J 


name 

indicates the name of the extended local LDC list and should be 
the same as that specified in the LDC operand of the DFHTCT 
TYPE= TERMINAL macro, and is only required if LOCAL=INITIAL is 
specified. 


TYPE=LDC 

indicates that an LDC is being defined to the system LDC table 
or to the extended local LDC list. 
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DSN=destination-name 

specifies the name to be used by BMS for destination selection 
for the batch data interchange logical unit. Refer to the 
relevant CICS/VS subsystem guides for further information on 
destination selection. 


DVC=device-type 

specifies the device type associated with the LDC to be used 
| for a BMS request. This operand may not be specified in 

J conjunction with the LDC=SYSTEMJ3600JBCHLU operand. Device 

types are specified as follows: 


Device Type 

Explanation 

3604 

keyboard display 

3610 

cut-forms document printer or journal 
printer (including the document/journal 
printer of a 3612) 

3612 

passbook portion of a 3612 

3618 

currently selected carriage 

3618P 

primary carriage 

3618S 

secondary carriage 

3618B 

both carriages 

BLUCON 

batch logical unit console printer 
or default print dataset group 

BLUPRT 

3784 printer or print dataset group 

BLURDR 

2502 or 3521 card punch with card read 
attachment 

BLUPCH 

3521 card punch 


Note : The device types BLUPRT f BLURDR, BLUPCH and BLUCON are 

devices attached to a batch logical unit or to a batch data 
interchange logical unit. 


| LDC=mnemonic 

specifies the LDC mnemonic and numeric value to be defined. 

| The default is LDC=SYSTEM. This operand may not be used in 

| conjunction with the DVC operand. 

SYSTEM 

indicates that the following system-default LDCs for the 
3600 system and batch logical unit are to be established: 
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LDC 

Mnemonic 


LDC 

Value 


Device 


Pagesize 
(row f column) 


DS 

1 

3604 Keyboard Display 

6,40 

JP 

2 

3610 Document Printer 

1,80 

PB 

3 

Passbook and Document 
Printer 

1,40 

LP 

4 

3618 Administrative 

Line Printer 

50,80 

MS 

5 

3604 Magnetic Stripe 

Encoder 

1,40 

CO 

0 

batch logical unit 

Console Printer or default 
print dataset group 


Rl 

32 

2502 or 3501 Card Reader 
or card read attachment 
on 3521 Card Punch 

1,80 

HI 

32 

3521 Card Punch 

1,80 

PI 

48 

3784 Printer or print 
dataset group 

50,80 


3600 

indicates that system-default LDC mnemonics for the 3600 
system are to be established* These consist of the LDC 
mnemonics DS, JP, PB, LP, and MS, the corresponding LDCs, 
the appropriate page size, and page status. 

BCHLU 

indicates that system-default LDC mnemonics for a batch 
logical unit are to be established. These consist of the 
LDC mnemonics CO, Rl, Pi, and Hi, the corresponding LDCs, 
the appropriate page size, and page status. 


aa 

indicates the two-character mnemonic to be used for this 

LDC. 

nnn 

indicates the numeric value to be associated with the 
LDC in the system or extended local LDC list. The 
value in the system list is used as a default value for 
this LDC if a value is not found in a local LDC list 
(which is not extended) associated with a TCTTE. A 
value must be specified for 3600 devices. A value need 
not be specified for batch or batch data interchange 
logical units, but if one is specified it must 
correspond to the device type. LDCs for devices 
attached to a batch logical unit are listed under the 
LDC parameter of the DFHTCT TYPE=LDC macro. 


1 LOCAL=INITIAL,FINAL 

indicates that an extended local LDC list is to be generated. 
INITIAL 

indicates that this is the start of an extended local LDC 
list. 
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FINAL 

indicates that this is the end of an extended local LDC 
list. 

Note : LOCAL=INITIAL or FINAL may not be specified in the same 

DFHTCT TYPE=LDC macro as other operands. All DFHTCT TYPE=LDC 
entries specified after LOCAL=INITIAL and before LOCAL=FINAL 
will form part of one extended local LDC list; the entries 
specified outside the structure of this group will be added to 
the system LDC table. See the extended local LDC list example 
below. 

specifies the logical page size to be used with this LDC when 
BMS requests are processed. 


PGESTAT= AUTOPAGE |PAGE 

specifies the type of paging activity that may occur for this 
LDC. The default is AUTOPAGE. 

AUTOPAGE 

indicates that all requests to output data from the page 
supervisor are to be automatically paged, unless specified 
otherwise in the DFHBMS macro instruction. When 
autopaging, the page supervisor writes all pages in a page 
series automatically. Requests to write data directly to 
the logical unit are not controlled by the PAGE or AUTOPAGE 
parameter because the page supervisor is not used for 
direct output. 

If the default PGESIZE and/or PGESTAT values provided by 
the LDC=SYSTEM|3600|BCHLU operand are to be overridden, a 
specific LDC should be coded with the mnemonic to be 
overridden. This overriding LDC must be coded in the LDC 
table prior to the SYSTEM, 3600, or BCHLU specification. 

If LDC=SYSTEM, 3600, or BCHLU are specified, DVC, PGSIZE, 
and PGESTAT should not be specified. 

Note : PGESTAT=AUTOPAGE may be used to override the PGESTAT 

specification in DFHTCT TYPE=TERMINAL. 


PAGE 

indicates that all requests to output data from the page 
supervisor are to be paged, unless specified otherwise in 
the DFHBMS macro instruction. When paging, the first page 
from the paging supervisor is written when the logical unit 
becomes available. All subsequent pages in a page series 
are written on request of the logical unit (through the 
operator if so designed) through the use of paging 
commands• 

The following is an example of an extended local LDC list. 


DFHTCT TYPE=TERMINAL,TRMIDNT=BTCH,TRMTYPE=BCHLU, 
ACCMETH=VTAM,LDC=LDCA 
LDCA DFHTCT TYPE=LDC,L0CAL=INITIAL 

DFHTCT TYPE=LDC,DVC=BLUPRT,LDC=AA,PGESIZE=(6,30) 
DFHTCT TYPE=LDC,DVC=BLUPCH,LDC=BB,PGESIZE=(1,80) 
DFHTCT TYPE=LDC,DVC=BLUC0N,LDC—CC,PGESIZE=(1,132), 
PGESTAT=AUTOPAGE 
DFHTCT TYPE=LDC,LOCAL=FINAL 
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LOCAL LDC LIST — DFHTCT TYPE=LDCLIST 

| The DFHTCT TYPE=LDCLIST macro instruction, which may be used with 3600 
| and batch logical units only, allows the user to build a common list of 
logical device codes (LDCs) to be shared by more than one TCTTE. 

The system programmer is responsible for setting up the LDC structure 
to be used with the terminal. 

To define a list of LDCs to be used by several TCTTEs, the following 
macro instruction must be generated: 


r r r 

jlistname| DFHTCT | TYPE=LDCLIST 

| | | ,LDC=(aa C=nnn3,bbt=nnn],cc Onnn],...) 

L-L-L- 


I 

I 


J 


listname 

is the required name of the LDC list. This name is referenced 
by TCTTEs through the LDC operand in DFHTCT TYPE=TERMINAL. 


TYPE=LDCLIST 

indicates that an LDC list is being defined. 


| LDC=mnemonic 

specifies the LDCs (mnemonics and, optionally, the LDC numeric 
value) in this list. 

(aa(=nnn],bb(=nnnl, ccOnnnl,...) 

generates the LDCs in the list. 

aa,bb,cc... 

are the two-character mnemonics of the LDCs in this 
list. 


nnn 

is a decimal value in the range 1 to 255 to be 
associated with an LDC. If a value is not specified, 
the system default value from the table defined by the 
DFHTCT TYPE=LDC macro instruction, is used for this 
LDC. This value need not be coded for a batch logical 
unit, but if it is, it must correspond to the device. 
LDCs for devices attached to a batch logical unit are 
listed under the LDC parameter of the DFHTCT TYPE=LDC 
macro. 
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COMMUNICATION LINES 


DFHTCT TYPE=LINE 


For sequential, TCAM, and BTAM terminals, communication paths to the 
terminals on the system can be described by the DFHTCT TYPE=LINE macro 
instruction. The expansion of this macro instruction is the terminal 
control table line entry CTCTLE) and contains the data event control 
block CDECB) which is used to communicate with the appropriate access 
method. The terminals related to this line must be described 
immediately following this macro instruction in the DFHTCT TYPE=TERMINAL 
macro instruction. However, when describing a switched-line network, 
all the lines for a given pool should be described before the terminals 
for that line pool are described. 

One or more DFHTCT TYPE=LINE macro instructions must be generated for 
each line group. The DSCNAME=name operand of each of the DFHTCT 
TYPE=LINE macro instructions must contain the same name as was specified 
in the DSCNAME=name operand of the related DFHTCT TYPE=SDSCI macro 
instruction. 

A DFHTCT TYPE=LINE macro instruction must be generated for each 
logical pair of sequential SDSCI macro instructions. For CICS/DOS/VS 
console terminal support, a DFHTCT TYPE=LINE macro instruction must be 
generated following the DFHTCT TYPE=SDSCI,DEVICE=CONSOLE macro 
instruction. 

A DFHTCT TYPE=LINE macro instruction must be generated for each 
symbolic unit (relative line) specified in the LINELST=parameter operand 
of the BTAM SDSCI macro instruction. The DFHTCT TYPE=LINE macro 
instruction entries must be contiguous on switched-line pools. For the 
local 3270 Information Display System under CICS/DOS/VS or CICS/OS/VS, 
only one DFHTCT TYPE=LINE macro instruction is generated for each line 
group. 

For Teletypewriters (WTC only), one DFHTCT TYPE=LINE and one DFHTCT 
TYPE= TERMINAL macro instruction must be specified for each line 
attachment in the system. 

A DFHTCT TYPE=LINE macro must be generated for each TCAM TYPE=SDSCI 
macro. 
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|DFHTCT 

•r 

1 

TYPE=LINE 

i 

1 

,ACCMETH=method 

i 

1 

, INAREAL= 1 engt h 

i 

1 

,TRMTYPE=type 

i 

1 

[,ANSWRBK={AUTOMATIC!TERMINAL! NULL!EXIDVER}] 

i 

1 

[.BSCODE={EBCDIC|ASCII}] 

i 

1 

t , BTAMRLN=number] 

i 

1 

[,CLASS=(t{CONV|BATCH}]l,{VIDEO!HARDCOPY|AUDIO}] 

i 

1 

[,BISYNC])] 

i 

1 

[,CONVTAB=code] 

i 

I 

[ , DSCNAME=name] 

i 

1 

1,ERRMSG=symbolic-address] 

i 

1 

[,FEATURE=(feature{ , feature],...)] 

i 

1 

t,GENPOLL=YES] 

i 

1 

[,ISADSCN=name] 

i 

1 

£,LINSTAT=*OUT OF SERVICE’] 

i 

1 

[,LISTADR=(name t,WRAP])] 

i 

1 

[,NPDELAY=number] 

i 

1 

(,0SADSCN=name] 

i 

1 

[,POOLADR=symbolic-address] 

i 

1 

[,RDYMSG=symbolic-address1 

i 

1 

[,TCTUAL={0|length}] 

i 

l 

1 

t,TRMMODL=model|character] 

1 

i 

t 

1 

1 

I 

For OS/VS Only 

1 

i 

1 

1 

t,OUTQ=symbolic-name] 

i 

1 

{,POOL=YES] 

i 

1 

I , POOLCNT=number] 

i 

1 

[,QUEUEID=hexadecimal-number] 

i 

1 

.i. 

[,TCAMFET=SNAl 


Note : Questions regarding terminal control table parameter selections 
may be clarified by referring to the TCT Configurator at the beginning 
of this section. 


TYPE=LINE 

specifies communication lines. 


ACCMETH=me thod 

specifies the access method to be used. Grouped according to 
synonymity of function, the applicable keyword parameters are: 

SAM, BSAM, SEQUENTIAL 

BTAM, TELECOMMUNICATION 

BGAM, GRAPHICS (CICS/0S/VS Only) 

TCAM, Telecommunications Access Method (CICS/OS/VS Only) 

When TRMTYPE=CONS OLE is specified (CICS/DOS/VS only), SAM is 
defaulted. 


INAREAL^length 

specifies the message input area length. This value, as a 
minimum, must be specified as follows: 

• For start/stop devices, the length should be equal to the 
length of the longest initial sentence of a transaction. 
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• For start/stop devices with the buffer receive feature (for 
example, the 2740 Communication Terminal Model 2), the 
length should be equal to the length of the buffer less two 
bytes. 

• For binary synchronous devices, the length may be 
calculated as (a+1)(b+2) + 1, where "a" is the number of 
blocks sent by a device in response to an RVI (reverse 
interrupt) from CICS/VS, and "b" is the size, in bytes, of 
each block. 

• For the remote 3270 Information Display System, the length 
specified should not be less than 254 or not less than 255 
if the automatic polling facility (FEATURE=AUTOPOLL) is 
used. 

• For the local 3270 Information Display System, the value 
specified may be any number greater than zero. This value 
indicates the minumum size of the Terminal Input/Output 
Area (TIOA) that will be passed to the transaction by the 
terminal control program. However, for performance 
considerations, the value specified should be equal to or 
greater than the length of the expected input message; at 
no time can a message be read whose length exceeds the 

| INAREAL value by more than 4000 bytes (unless the 

transaction provides a TIOA for the read large enough to 
contain the message). 

• For sequential (BSAM) devices, the length should be equal 
to the length of the longest initial logical record of a 
transaction which may include multiple physical records. 
(See "EODI" under DFHSG PROGRAM=TCP.) 

• For CONSOLE devices, the maximum length (and default) is 
80. Shorter input area lengths may be specified if 
desired. 

Note: The minimum TIOA passed to a transaction which is 

running under control of 2260 compatibility is governed by the 
CMPT60L operand in the DFHSG PROGRAM=TCP macro instruction. 


TRMTYPE=type 

specifies the terminal type associated with this communication 
line. One of the following may be specified: 

1050, 1053, 2260, L2260, 2265, 2740, 2741C, 2741E, 2770, 
2780, 2980, 3275, 3277, L3277, 3284, L3284, 3286, L3286, 
3600, 3660 3735, 3740, 3780, 7770, SYS/3, SYS/7, S370, 
S/7BSCA, CRLP, DASD, TAPE, TLX, TWX, U/R, TCAM (CICS/OS/VS 
only), or CONSOLE (CICS/DOS/VS only). 

Notes : 

1. TRMTYPE= 3286 or L3286 also generates support for the 3288 
printer- 

| 2. 3277 or L3277 must be specified for 3276 or 3278 displays. 
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| 3. 3284, L3284, 3286, or L3286 must be specified for 3287 or 

| 3289 printers. 

Only one TRMTYPE operand can be included in each DFHTCT 
TYPE=LINE macro instruction. This operand, when specified, 
establishes the default specification that will be used when 
the TRMTYPE operand is not specified in a DFHTCT TYPE=TERMINAL 
macro instruction associated with this line. If no TRMTYPE 
operand is specified in the DFHTCT TYPE=LINE macro instruction, 
a TRMTYPE operand must be supplied in each DFHTCT TYPE=TERMINAL 
macro instruction for that line. 

The use of the TRMTYPE operand in the DFHTCT TYPE=LINE macro 
instruction is optional unless one of the following conditions 
exists 2 

• A 7770 is associated with the line. 

• A local 3270 is associated with the line. 

• One or more remote 3270s or 3740s are associated with the 
line. 

• A 3600 BSC device is associated with the line. 

In each of these cases an appropriate device-type parameter 
must be specified in the TRMTYPE operand as follows: 

• TRMTYPE=7770 for the 7770. 

• TRMTYPE=L3277, TRMTYPE=L328 4, or TRMTYPE=L3286 for a local 
3270. 

• TRMTYPE=3275, TRMTYPE=3277, TRMTYPE=3284, TRYTYPE=3286, or 
TRMTYPE=3740 for a remote 3270 or 3740. 

• TRMTYPE=3600 for a 3600 Finance Communication System using 
BTAM. If a remote 3270 and a 3600 BSC device are both 
associated with one line, the remote 3270 must be 
specified. 

TWX is the CPT-TWX (Model 33/35), DASD is a direct access 
storage device, CRLP is a card reader and line printer (a pair 
of sequential devices simulating a terminal), TAPE is a 
magnetic tape device, U/R is a general term that refers to any 
reader, or printer, and S/7BSCA is the System/7 with the Binary 
Synchronous Communications Adapter. 

CONSOLE is the processor printer/keyboard or display operator 
console and is valid for CICS/DOS/VS only. 

TCAM is used to specify a TCAM-only terminal associated with 
this communication line. This allows terminals supported by 
TCAM to use the TCAM interface through CICS/OS/VS. Device 
dependent editing must be handled by the user's message control 
program if a TCAM terminal type is specified. CICS/VS systems 
programs only insert NL characters. 

When using TCAM, the following parameters are required: 
ACCMETH=TCAM, DSCNAME, and INAREAL. QUEUEID, NPDELAY, 
TCAMFET=SNA, and OUTQ are optional. TCAM is valid for 
CICS/OS/VS only. 

If either 3270 data stream or 2260 support is required under 
TCAM, the appropriate 3270 terminal type (for example, 3277, 
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This 


3284, L3286) or the appropriate 2260 terminal type (for 
example, L2260) must be specified in the TRMTYPE operand, 
will enable BMS to generate the correct data stream. 
TRMTYPE==TCAM should be used for all other terminals which 
require EBCDIC support. BMS will supply new line editing for 
those terminals specified in this way. 

For details of TCAM SNA device support, refer to the 
TCAMFET=SNA operand later in this macro. 


| ANSWRBK=identification 

must be indicated for switched lines to specify the terminal 
identification to be used. If this operand is used, 
FEATURE=AUTOANSR must also be specified. Only one of the 
following keyword parameters may be specified: 

AUTOMATIC 

indicates automatic terminal identification. This 
parameter may be coded only for the Common Carrier 
Teletypewriter Exchange Terminal Station (Model 33/35) and 
for the Teletypewriter (WTC only). 

TERMINAL 

indicates that the terminal will be identified by the 
operator. This parameter may be coded for the TWX, 1050, 
2740, 2741, and dial-up binary synchronous devices. (After 
the dial-up connection has been made, the operator must 
enter the terminal identification as it appears in the 
terminal control table.) If 3275s or 3735s share the line, 
EXIDVER should be specified. 


NULL 

indicates that the terminal will not be identified by 
either the terminal or the operator. This parameter may 
only be specified for the 7770. (After the dial-up 
connection has been made, the terminal control program 
connects this line to the next available terminal in the 
terminal pool.) 

EXIDVER 

indicates that the terminal's unique ID sequence will be 
identified by BTAM-expanded ID verification. This 
parameter may be coded for any line on which there is a 
3275 or 3735. If devices which do not transmit unique ID 
sequences share the line with 3275s or 3735s, the operator 
must enter the terminal identification for these devices 
after the dial-up connection has been made. 

Note : These keyword parameters are valid only if the 

corresponding keyword parameters have been included in the 
DFHSG PROGRAM=TCP,ANSWRBK=(identification) operand. 


| BSCODE=EBCDICjASCII 

specifies the type of communication code to be used for a given 
binary synchronous communication device. The default is 
BSCODE—EBCDIC. 

EBCDIC 

indicates transmission in Extended Binary Coded Decimal 
Interchange Code. 


254 


CICS/VS System Programmer's Reference Manual 



ASCII 

indicates transmission in American Standard Code for 
Information Interchange. 


BTAMRLN=number 

specifies the relative line number within a line group. The 
relative line number can be specified in the range from 1 
through 32 for CICS/DOS/VS and from 1 through 256 for 
CICS/OS/VS. This operand is not applicable to BSAM, BGAM, or 
local 2260s and local 3270s for CICS/DOS/VS. 


| CLASS=device-classification 

indicates the device classification associated with this 
communication line. The CLASS specified for the line becomes 
the default CLASS specification for terminals on that line. 

The applicable keyword parameters are: 

CONV 

Device with conversational type application 
BATCH 

Data collection type device 
VIDEO 

Device with cathode ray tube. Also, all units of the 3270, 
| including 3270 printers 

HARDCOPY 

Hard-copy start-stop device (that is, the TWX, 1050, 2740, 
and 2741 terminals) 

AUDIO 

Audio response device 
BISYNC 

Binary synchronous device 

Multiple parameters may be specified, taking into account that 
the following groups are mutually exclusive: CONV and BATCH; 
VIDEO, HARDCOPY, and AUDIO. 

BISYNC should be specified for any binary synchronous device. 
For example, a remote 3270 could be described as 
CLASS=(CONV,VIDEO,BISYNC) and a local 3270 as 

CLASS=(CONV,VIDEO). This operand does not apply when CONSOLE 
is specified as device; it is required in either the TYPE=LINE 
or TYPE=TERMINAL macro for all other non-VTAM devices. 


| CONVTAB=transmission-code 

specifies the type of transmission code, and may be used 
instead of the BSCODE operand for binary synchronous devices. 
The applicable keyword parameters are: 

EBCDIC 

Extended Binary Coded Decimal Interchange Code 
ASCII 

American Standard Code for Information Interchange 
TEXTMODE 

Text mode for the 2741 Communication Terminal 
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ABB 


ABB code for the 7770 Audio Response Unit Model 3 

ABC 

ABC code for the 7770 Audio Response Unit Model 3 


DSCNAME=name 

specifies the data set control name for this communication 
line. It is not applicable for BSAM. The DSCNAME for BTAM and 
TCAM data sets must be the same name as that specified in the 
DSCNAME=name operand of the related DFHTCT TYPE=SDSCI macro 
instruction. 


ERRMSG=symbolic-address 

specifies the symbolic address of the error message used by 
CICS/VS to communicate with terminals attached to the 7770 
Audio Response Unit. The error message is required when 
TERMTYPE=7770 is specified and is defined through the DFHTCT 
TYPE=777OMSG macro instruction (see the "Digital Response 
Messages for the 7770 Audio Response Unit" macro later in this 
section.) 


| FEATURE=f eature 

indicates that one or more optional features are present on a 
given terminal. These features can be specified in any order 
using the following keyword parameters: 

AUTOANSR 

the automatic answering feature for switched lines. For 
terminals on switched-line networks, FEATURE=AUTOANSR must 
always be specified. 

AUTOCALL 

the automatic calling feature for switched lines. 

AUTOPOLL 

the automatic polling feature required for multipoint 
binary synchronous communication terminals and optional for 
the 1050 Communication System and 2740 Communication 
Terminal. If AUTOPOLL is specified for the 2740, SCONTROL 
must also be specified. FEATURE=AUTOPOLL must be specified 
if AUTOLST or AUTOWLST is specified in the BTAM DFTRMLST 
macro. 

CHECKING 

the VRC/LRC checking feature on the 2740 Communication 
Terminal. 

SCONTROL 

the station control feature on the 2740 Communication 
Terminal and on the System/7 with ACCA. 

BUFFRECV 

the buffer receive feature for the 2740 Communication 
Terminal Model 2. If BUFFRECV is specified, SCONTROL must 
also be specified. 

KBRDLOCK 

the lock option capability for the 2848 Display Control 
Unit Models 21 and 22. 
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GENPOLL=YES 

must be specified for a multipoint binary synchronous 
communication line if one or more of the polling sequences in 
the DFTRMLST macro instruction is a general poll sequence. If 
this operand is used f the POLLPOS operand must be included in 
each DFHTCT TYPE=TERMINAL specification associated with the 
line. For TRMTYPE=2980, TRMTYPE=3270, and TRMTYPE=3600, 
GENPOLL=YES is a default specification. 


ISADSCN=name 

specifies the input BSAM data set control name for a particular 
communication line. This data set control name must be the 
same name as that specified in the DSCNAME=name operand of the 
related DFHTCT TYPE=SDSCI macro instruction. This operand is 
applicable to BSAM, SAM, and Sequential only. This operand 
does not apply when CONSOLE is specified as a device. 


LINSTAT= *OUT OF SERVICE* 

indicates that the line is to be initiated with an "out of 
service" status. The default is "in service." 


| LISTADR=name 

specifies the name of the BTAM define-terminal-list macro 
instruction (DFTRMLST) in which the user has specified a 
polling list for the communication line. Use of the prefix 
| "TCT" in the label could cause assembly errors. DFTRMLST 

entries should be coded immediately preceding DFHTCT TYPE=LINE 
entries or immediately following DFHTCT TYPE=TERMINAL entries. 
One separate DFTRMLST must be coded for each communication line 
on a switched network. A terminal must not be specified more 
than once in a polling list. 

name 

indicates the name of the label of the DFTRMLST macro 
instruction. 


WRAP 

indicates that a wraplist was specified in the DFTRMLST 
macro instruction. The default is an open list. 

LISTADR is not applicable when ACCMETH=BSAM, or for some 
devices when ACCMETH=BTAM (for example, dial-up 2741s). 

If ANSWRBK=EXIDVER is specified, the LISTADR operand must 
specify the name of a DFTRMLST macro instruction of the 
SWLST,AN format. The user data portion of the entries in this 
list must be either of the following: 

1. The name of the corresponding DFHTCT TYPE=TERMINAL macro 
instruction for each 3275, 3735, and 3740; or 

2. Hexadecimal zeros for terminals that share the line with 
the 3275, 3735, or 3740 but do not transmit unique ID 
sequences. 

For a dial-up line containing 3275s, 3735s, 3740s, and other 
binary synchronous devices, the answering list must be coded as 
follows: 
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I 


* 

* 


symbol DFTRMLST SWLST,AN,xx,4,yy ,zz, 

(authsequence,0,userdata) 

(2D,0,ZERO) 

where: symbol is the user name specified by 

the LISTADR= operand of the DFHTCT TYPE=LINE 
macro instruction 

and ,xx,yy,zz are as defined in the BTAM manual. 

(authsequence,0,userdata) 
is a sublist in the answering list 
for each 3275, 3735, or 3740 in which: 
authsequence is as defined in the BTAM manual, 

0 must be specified for the control value, 
and userdata is the name of the DFHTCT TYPE=TERMINAL entry. 
(2D,0,ZERO)is a sublist in the answering list for all 
non-3275/3735/3740 devices on the line where: 

2D is the ID ENQ sequence for non-3275/3735/3740 devices, 
0 must be specified for the control value, 
and ZERO is the name used to represent user data - 

(the following statement must be coded: ZERO EQU 0). 


Notes: 


I 


I 

I 

I 

I 

I 

I 


1. For 2260 remote BTAM support, the polling list must specify 
a general pool. In this form of operation, achieved by 
coding X'FF' as the second byte of a single polling list 
entry, all display stations connected to the display 
control unit (identified by the first character of the 
polling list entry) are polled. 

2. Polling list entries for remote non-dial 3270 displays must 
specify a general poll. The use of a general poll allows a 
single entry in the polling list to invite input from all 
devices attached to each remote control unit or display 
station. 

In this form of operation, the polling list should contain 
only one entry for each 3270 control unit or for each 3270 
display on the line. For 3270 systems, this form of 
operation is achieved by using a device address code of 
X*7F* (EBCDIC) or X'22" (ASCII) in each polling list entry 
applicable to a 3270 control unit or 3270 station. For 
remote 3270s, see the discussion of GENPOLL in this section 
and the discussion of POLLPOS in DFHTCT TYPE=TERMINAL 
below. For Teletypewriters (WTC only), a DFTRMLST macro 
instruction should be used with the WTTALST operand. 

3. Manual dial-out is not supported in CICS/VS. 

For more information, see DOS/VS Basic Telecommunications 
Access Method or OS/VS Basic Telecommunications Access 
Method. 


NPDELAY=n umber 

signifies negative poll delay which specifies the interval of 
time, in milliseconds, between line polls (invitations) when a 
negative response to a poll is detected. This number can be 
specified in the range 0 to 20000, with default values varying 
by device type. NPDELAY is only applicable to start/stop and 
| binary synchronous devices, but may not be specified for lines 

j which use WRAPLST, AUTOWLST, or SSAWLST. 
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When used with a TCAM line, this parameter specifies the time 
interval that is to expire before control is passed to DFHTEP 
when a CICS/OS/VS task is not ready to accept a record from an 
input process queue. 

If the CICS/OS/VS task issues a read before the time interval 
expires, processing continues normally and DFHTEP is not 
notified. The default value is zero. 


OSADSCN=name 

specifies the output BSAM data set control name for a 
particular communication line. This data set control name must 
be the same name as that specified in the DSCNAME=name operand 
of the related DFHTCT TYPE=SDSCI macro instruction. This 
operand is applicable to BSAM, SAM, and Sequential only and 
does not apply when CONSOLE is specified as a device. 


POOLADR=symbolic-address 

must be used for switched-line processing and for the local 
3270 Information Display System. For switched-line or local 
3270 processing, this operand specifies the label assigned to 
the first terminal description macro (DFHTCT TYPE=TERMINAL) 
associated with a particular pool of communication lines or 
local 3270s. However, POOLADR should only be specified for the 
first line in a given line pool; FEATURE=AUTOANSR must also be 
specified. 

For a Teletypewriter (WTC only) line, this operand specifies 
the name assigned to the terminal description (DFHTCT 
TYPE=TERMINAL> associated with this line. 


RDYMSG=symbolic-address 

specifies the symbolic address of the ready message used by 
CICS/VS to communicate with terminals attached to the 7770 
Audio Response Unit. The ready message is required when 
TRMTYPE=7770 is specified and is defined through the DFHTCT 
TYPE=7770MS6 macro instruction. (See "Digital Response 
Messages for the 7770 Audio Response Unit" below.) 


TCTUAL=length 

specifies the length, in bytes (0 to 255), of the process 
control information field (PCI) for all terminal entries 
(TCTTEs) associated with this line. The default is TCTUAL=0. 
The TCT user area length is initialized to zeros at system 
initialization. 

If fields of different (variable) lengths are desired, the 
TCTUAL value can be specified in one or more DFHTCT 
TYPE=TERMINAL macro instructions for terminals associated with 
this line. In any case, the PCI field is generated for each 
terminal after the last terminal entry of the last line. The 
address of the PCI field is located at TCTTECIA; the length is 
located at TCTTECIL. 

For CICS/OS/VS, PCI fields of fixed length (15 bytes) and/or 
variable length (0 to 255 bytes) can be specified by the TCTUA 
operand of the DFHSG TYPE=INITIAL macro instruction. In the 
case of a fixed-length PCI field (the address of which is 
located at TCTTECI), the TCTUAL operand need not be specified. 
In the case of a variable-length PCI field (the address of 
which is located at TCTTECIA), the TCTUAL operand should be 
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specified in the DFHTCT TYPE=LINE macro instruction and/or in 
the DFHTCT TYPE=TERMINAL macro instruction. 


| TRMMODL=model-number 

This operand specifies the model number of the terminal 
associated with this communication line. This operand must be 
used if the device is one of the following: 

• Component of the 1050 Data Communication System 

• 2740 Communication Terminal Model 2 

• Component of the 2980 General Banking Terminal System 

• Component of the 3270 Information Display System 

• 2260 Display Station 

• 2265 Display Station 

The TRMMODL parameter sets the default value that will be 
taken, when it is not specified in the DFHTCT TYPE=TERMINAL 
macro instruction associated with that line. If models vary on 
a line, the macro instruction can have a TRMMODL parameter 
associated with it which is different from that specified in 
the DFHTCT TYPE=LINE. This will override the DFHTCT TYPE=LINE 
macro instruction for that DFHTCT TYPE=TERMINAL macro 
instruction. 

model 

TRMMODL=l is used to specify the 2980 Teller Station Model 
| 1, or 3270 Model 1 displays and printers TRMMODL=l is the 

j default for the 3270 Information Display System and 

J indicates 3270 displays and printers with a default screen 

| or buffer width of 40 characters. 

TRMMODL=2 is used to specify the 2740 Communication 
| Terminal Model 2, 2980 Administrative Station Model 2, or 

j 3270 Model 2 displays and printers with a default screen or 

| buffer width of 80 characters.. 

TRMMODL=4 is used to specify the 2980 Teller Station Model 
4. 

TRMMODL=5 is used to specify component polling of the 
keyboard for the 1050 Data Communication System using 
nonswitched communication lines. Component selection 
character 5 (0B) must be coded in the polling list 
(DFTRMLST). 

TRMMODL=6 is used to specify component polling of reader 1 
for the 1050 Data Communication System using nonswitched 
communication lines. Component selection character 6 (0D) 
must be coded in the polling list (DFTRMLST). 

TRMMODL=7 is used to specify the component polling of 
reader 2 for the 1050 Data Communication System using 
nonswitched communication lines. Component selection 
character 7 (0E) must be coded in the polling list 
(DFTRMLST). 
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TRMMODL=0 is used to specify an input component for the 
1050 Data Communication System. Common polling character 0 
(15) must be coded in the polling list (DFTRMLST). 

TRMMODL=0 is the default specification for a 1050 Data 
Communication System. 

character 

The TRMMODL=character operand is used to specify the 
applicable screen format for a 2260/2265 display station as 
follows: 


SPECIFICATIONS 

SCREEN 

FORMAT 

TRMMODL=A 

6x40 

2260 

TRMMODL=B 

12x40 

2260 

TRMMODL=C 

12x80 

2260 

TRMMODL=D 

15x64 

2265 

TRMMODL=E 

12x80 

2265 


For example, TRMMODL=A specifies a 2260 Display Station 
with a 6x40 screen format. 

Note : When TRMMODL is specified, the user must also 
specify the component selection character with control unit 
address through the TRMADDR operand of the DFHTCT 
TYPE=TERMINAL macro instruction. 


For CICS/OS/VS only 


OUTQ=symbolic-name 

is required in all TCAM input process queue terminal control 
table line entries. The symbolic name identifies the 
corresponding TCAM output process queue TCTLE. Multiple input 
process queues may reference the same output process queue. 


POOL=YES 

specifying POOL=YES on the TCAM output process queue indicates 
that the TCAM POOL feature is supported for that TCAM line. 
Before using this parameter, the user should analyze the POOL 
feature restrictions discussed in "The CICS/OS/VS TCAM 
Interface" in Chapter 5.3 of this manual. 


P OOLC NT=number 

specifies the number of terminal control table line entries 
(TCTLEs) to be included in the pool of TCTLEs for a line group 
comprised of local 3270 Information Display Systems. The pool 
of TCTLEs is used by CICS/OS/VS to support concurrent 
operations on the BTAM local line group. 

The number of TCTLEs specified should reflect the expected 
activity on the local line group and the anticipated maximum 
number of concurrent requests. For a local line group 
containing printers, the number specified should be the actual 
number of printers plus one, to avoid locking out any screen 
keyboards when all printers are busy. 

When a READ or WRITE for a particular 3270 is issued, 
CICS/OS/VS allocates the first available TCTLE from the pool. 
This TCTLE is freed when the operation at the device is 
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complete- For WRITE operations at a printer, the operation at 
the device is considered complete when the printing operation 
is complete. For CICS/OS/VS, local 3270s can be arranged in 
line groups in any desired manner. 

CICS/OS/VS supports as many concurrent operations on the line 
group as there are TCTLEs in the pool. If no TCTLE is 
available to support a requested operation, the request remains 
pending until a TCTLE becomes available. 

Note : This is a required parameter for CICS/OS/VS using local 

3270s. 


QUEUEID=hexadecimal-number 

is used to specify a unique user ID for the TCAM process queue. 
The ID is an unframed, one byte hexadecimal number (00 to FF) 
which is placed in the input and output line entry at TCTLEQID 
to provide queue identification while executing a user exit. 


TCAMFET= S NA 

must be specified if TCAM SNA devices are to be used on this 
line. The same DFHTCT TYPE=LINE macro must not include 
specifications for TCAM SNA and non-SNA devices. Specifying 
TCAMFET=SNA allows TCAM SNA devices to be used in conjunction 
with the TRMTYPE/SESTYPE combination of operands in DFHTCT 
TYPE=TERMINAL to generate logical units. This operand is 
required if SNA support (for example, FMH) is to be supplied by 
BMS or by DFHDIP. 


DATA SET CONTROL INFORMATION — DFHTCT TYPE=SDSCI 

For sequential, TCAM, and BTAM terminals, the user can specify data set 
control information through the DFHTCT TYPE=SDSCI macro instruction, 
which causes the operating system to generate the appropriate data set 
control information. DFHTCT TYPE=LINE and DFHTCT TYPE=TERMINAL macros 
are also required. DTF information is generated in CICS/DOS/VS; DCB 
information is generated in CICS/OS/VS. 

Two DFHTCT TYPE=SDSCI macro instructions mu££ be generated for each 
sequential terminal. One macro instruction is jfegr the sequential input 
data set and the other macro instruction is for the sequential output 
data set. This input/output data set combination simulates the input 
and output functions of a terminal. One DFHTCT TYPE=LINE macro 
instruction must be generated for this I/O combination. 

One DFHTCT TYPE=SDSCI macro instruction must be specified for each 
BTAM line group, where a line group is a group of communication lines 
which meet the following operational requirements: 

• All lines in the group are attached to the channel through the same 
type of telecommunications control unit; for example, a 2701. 

(This is true only for the CICS/DOS/VS system.) 

• The line connection between the control unit and the remote devices 
is of the same type; for example, a switched network. 

• All devices within the line group have the same line features and 
operating characteristics; for example, autopoll. 
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| DEVICE=device 

specifies the valid device types for this data set in the 
terminal control table. One of the following may be chosen: 

| 1050, 1403, 1404, 1442 (as a card reader only), 1443, 1445, 

2260, L2260, 2265, 2314, 2501, 2520, 2540, 2560 (as a card 
reader only), 2596, 2740, 2741C, (with correspondence code) 
2741E, (with PTTC/EBCD code) 2770, 2780, 2980, 3203, 3211, 

| 3275, 3277, L3277, 3284, L3284, 3286, L3286, 3330, 3340, 3350, 

j 3505, 3525 (as a card reader only), 3600, 3660, 3735, 3740, 

3780, 5203, 5425 (as a card reader only), 7770, BSCMDMPT, 
BSCMDPPT, BSCMDSW, CONSOLE (CICS/DOS/VS only), DASD, DISK, 
SYS/3, SYS/7, S370, S/7BSCA, TAPE, TLX, TW33, TW35, TCAM 
(CICS/OS/VS only). 

L2260 signifies "local video attachment." 

2260 and 2265 signify "remote video attachment." 
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Support for the 1053 printer is automatically included when any 
of these devices (2260 f L2260, 2265) are specified. 

| L3277, L3284, and L3286 signify "local 3270 attachment." 3277 

I or L3277 must be specified for a local 3278, and L3284 or L3286 

| indicates a local 3287 or 3289. 

| 3275, 3277, 3284, and 3286 signify "remote 3270 attachment." 

| 3284 or 3286 must be specified for a remote 3287 or 3289. 

3600 specifies binary synchronous nonswitched multipoint 3600 
devices. 

BSCMDPPT signifies "mixed binary synchronous point-to-point 
devices." 

BSCMDSW signifies "mixed binary synchronous switched devices." 

BSCMDMPT signifies "mixed binary synchronous multipoint 
devices." 

For direct access devices, either the device type or the 
generic parameters DASD or DISK may be specified. 

The TAPE specification generates tape work files for both the 
input and the output data sets. Note that if an input tape 
with an expired label is used, the header may be rewritten, 
causing the first data records to be destroyed. 

The S/7BSCA specification is the System/7 with Binary 
Synchronous Communications Adapter. 

TCAM (CICS/OS/VS only) causes CICS/OS/VS to generate the 
appropriate data set control information to handle the TCAM 
input or output process queue. 

Notes: 


1. When the 3660 is used with DOS/VS, MNOTEs will be issued in 
the following circumstances: 

SWITCH=YES will be assumed if not specified explicitly. 

If CONFIG=MPT is specified, CONFIG=PPT and SWITCH=YES 
will be assumed. 

2. In generating a TCAM-only system, the following operands do 
not apply: FEATURE, BSCODE, ANSWRBK, CONVTAB, COMPAT, 
BTAMRLN, ISADSON, OSADSON, and LISTADR. 

3. DEVICE=3286 or L3286 also generates support for the 3288 
printer. 


DSCNAME=name 

specifies the symbolic data set control name associated with 
the data set control information. 

The DSCNAME for the sequential input data set must be the same 
name as that specified in the ISADSCN=name operand of the 
DFHTCT TYPE=LINE macro instruction. The DSCNAME for the 
sequential output data set must be the same name as that 
specified in the OSADSCN=name operand of the DFHTCT TYPE=LINE 
macro instruction. 
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The DSCNAME for BTAM data sets must be the same name as that 
specified in the DSCNAME=name operand of the DFHTCT TYPE=LINE 
macro instruction* This operand is not required for console 
terminal support under CICS/DOS/VS. 


BLKSIZE=length 

specifies, for sequential data sets and 7770 Model 3s, the 
maximum length (in bytes) of a block. 

For CICS/OS/VS, the default is BLKSIZE=0. If this operand is 
omitted, the block size can be specified in the data definition 
(DD) statement associated with the data set. A more detailed 
explanation of this operand is given in OS/VS Data Management 
Macro Instructions . 

For CICS/DOS/VS, the default is BLKSIZE=80. A more detailed 
explanation of this operand is given in DOS/VS Supervisor and 
I/O Macros . 

For 7770 Model 3s this value should be the same as that 
specified for INAREAL in the line entries that reference the 
DSCNAME of this DFHTCT TYPE=SDSCI macro instruction. 


| BSCODE= EBCDIC j ASCII 

specifies the type of binary synchronous transmission code. 
The default is BSCODE=EBCDIC. 

EBCDIC 

indicates transmission in Extended Binary Coded Decimal 
Interchange Code. 

ASCII 

indicates transmission in American Standard Code for 
Information Interchange. 


| ERROPT=option 

specifies the error recovery, error recording, and online test 
options to be provided for the line group. The applicable 
keyword parameters are: 

E 

specifies that the basic error recovery procedures are to 
be provided for the line group. If ERROPT is omitted, 
ERROPT=E is assumed. 

R 

specifies that text-read errors are to be retried in 
addition to the basic error recovery procedures. This 
option is only valid for the following terminals: 1050 
terminals (valid for the card reader and paper tape reader 
only if the line correction feature is installed), 2740 
terminals with the checking feature, and 2260 terminals. 

W 

specifies that text-write errors are to be retried in 
addition to the basic error recovery procedures. This 
option is valid for start/stop terminals. It results in an 
additional copy of the message for each retry (except for 
the 2260 with line address feature, and the 1050 card punch 
and paper tape punch with the line correction feature). 

This parameter is ignored for binary synchronous terminals. 
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c 

specifies that threshold error counts and cumulative error 
counts are to be maintained in the line error recording 
block (LERB) for the line for data check, intervention 
required, and non-text timeout errors. This parameter is 
applicable only to CICS/OS/VS. For CICS/DOS/VS, the LERB 
support is generated if the LERBADR parameter is specified. 

N 

specifies that no error recovery procedures are to be 
provided for the line group. This parameter and E,R,W f and 
C are mutually exclusive. This parameter is invalid for 
binary synchronous stations; if coded, it is ignored. For 
Teletypewriters (WTC only), N is default. 

RW 

specifies that error recovery is to be performed with "read 
text retry" and "write text retry." 

T 

specifies that the online test facility is to be used for 
the line group. Applicable only to CICS/OS/VS, this 
parameter is valid for all IBM terminals with or without 
error recovery capability. 

Notes : 

1. For CICS/OS/VS, EROPT is also a valid spelling of this 
operand. 

2. Commas must not be coded in this operand. For example, 
ERROPT=RECWT. 

3. ERROPT= is not valid for TCAM devices because error 
recovery is performed in the message handler. 


LERBADR= symboli c-addr e s s 

specifies the label of the BTAM line error recording block 
(LERB) which the user creates by means of the BTAM * LERB• macro 
instruction. LERB is also a valid spelling. 

Notes : 

1. For CICS/OS/VS, this parameter should not be specified 
unless ERROPT=C is also specified. 

2. This parameter should not be specified for local terminals 

| (2260L or 3270L). 


For CICS/DOS/VS only 


| CONFIG=PPT|MPT 

specifies the type of binary synchronous line configuration. 
The default is CONFIG=PPT. 

PPT 

indicates that the data link between the processor and the 
remote binary synchronous device is point-to-point. 
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MPT 


indicates that the data link between the processor and the 
remote binary synchronous devices is a multipoint link. 

Note ; MPT should be specified for terminals using the 
multipoint procedure even if there is only one terminal 
| installed at that line. (For example, a 3270 display on a 

nonswitched line.) See DOS/VS Basic Telecommunications 
Access Method for additional information. 


CU=unit 

defines the control unit attached to the channel. 2701, 2702, 
2703, 2848, 3272 or 7770 may be specified. This operand is 
| required for all nonsequential devices. CU=2701 is specified 

| for a System/370 Model 135 or 138 with an ICA with start-stop 

or BSC devices attached. CU=2703 is required for Models 115 or 
125 with an ICA. 


DEVADDR=SYSnnn 

specifies the symbolic unit address (sequential device) used 
for sequential terminal data sets. This operand is not 
required for CICS/DOS/VS console terminal support; SYSLOG will 
be used. 


| EOM=signal 

identifies the EOM (end of message) signal recognized by a 
Teletypewriter (WTC only). 

EOM=WRU 

indicates that the WRU signal (FIGS D) is used to separate 
incoming messages. EOM=WRU is the default option. 

EOM=X*hh f (where # hh* is the hexadecimal representation of FIGS 
x) 

is used only when FIGS x is not set in the World Trade 
Telegraph Adapter (WTTA) as FIGS D. 

EOM=X f hhlF* (where f hh* is the hexadecimal representation of 
FIGS y set in the WTTA) 

indicates that the FIGS y LTRS termination is used as end 
of message. 


| EOT=feature 

identifies the EOT (end of transmission) signal recognized by a 
Teletypewriter (WTC only). 

EOT=2EOM 

indicates that two consecutive EOM signals are defined by 
the user as end of transmission. 

EOT=X * hhlF 1 " 

specifies that the FIGS y LTRS termination is used as end 
of transmission. Therefore, EOM=X f hhlF* cannot be used as 
an end of message signal. 

Note; In the above descriptions of the EOM and EOT operands, x 
and y are the values assigned by the user. 
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| FEATURE=feature 

specifies device-dependent machine special features and 
programming special features. The applicable keyword 
parameters ares 

STC 

specifies that the 2740 or System/7 with ACCA is equipped 
with the station control feature. 


CHK 

specifies that the 2740 or System/7 with ACCA is equipped 
with the checking feature (CHK must always be specified for 
the System/7.) 

BSC 

must be specified when the DEVICE operand specifies a 
binary synchronous device. 

KBL 

specifies that the 2848 control unit is equipped with the 
data entry feature. The Lock optypes are rejected as 
undefined if this parameter is not used. 

SIX, SXW, or SIW 

may be used if ID verification for a calling operation is 
to occur in a binary synchronous point-to-point dial 
system. A more detailed explanation of these codes is 
given in DOS/VS Basic Telecommunications Access Method . 

| (See Note). 

RIX, RXW, or RIW 

may be used if ID verification for an answering operation 
is to occur in a binary synchronous point-to-point dial 
system. A more detailed explanation of these codes is 
given in DOS/VS Basic Telecommunications Access Method . 

| (See Note). 

| Note : The SIX, SXW, SIW, RIX, RXW, and RIW parameters 

| should not be used with expanded ID verification, that is, 

they should not be included if ANSWRBK=EXIDVER is specified 
in the DFHTCT TYPE=LINE macro. 

MAS or SLV 

may be used to specify whether the processor is to be 
Master (MAS) or Slave (SLV) when contention occurs in a 
binary synchronous processor-to-processor contention system 
(private line). If this operand is not used, FEATURE=MAS 
is assumed for this system. 

If FEATURE=MAS is specified, the remote device is to be the 
slave when contention occurs. If FEATURE^SLV is specified, 
the remote device is the master. When the remote device is 
the 2780, FEATURE=SLV must always be specified. The 
processor must always be the slave when contention occurs 
between the processor and the remote 2780. 

APL 

specifies that the autopoll feature is to be employed for 
the start/stop devices. If FEATURE-APL is omitted, the 
generated channel programs for these devices will perform 
the standard programmed polling. A more detailed 
explanation of this code is given in DOS/VS Basic 
Telecommunications Access Method. 
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IAM 


specifies that a Teletypewriter (WTC only) can ask for the 
computer identification by sending FIGS D. 


WRU 

specifies that both a Teletypewriter (WTC only) and the 
computer can request each other B s identification by sending 
FIGS D. When WRU is specified, IAM is assumed. If neither 
IAM or WRU are specified, no exchange of identification can 
be performed. 

MON 

specifies that the Teletypewriter (WTC only) is equiped 
with the motor-on optional feature. 

Note : In CICS/OS/VS, IAM, WRU, and MON are part of the 

appropriate BTAM DCB. For additional information, refer to the 
DOS/VS BTAM and OS/VS BTAM manuals. 


LINELST=nnn 

specifies the correspondence between symbolic unit (SYSnnn) and 
relative line number. The user codes one three-digit number 
(nnn of SYSnnn) for each line in the line group. The order in 
which the three-digit numbers are coded determines which 
symbolic units are associated with the individual lines in the 
line group. As many as 32 three-digit numbers from 000 through 
244 may be specified in this operand. 

For local 3270s and local 2260s, each number entry represents a 
physical device. 


MODELST=COde 

is used to specify a code (0, 1, 2, or 3) for each line in a 
binary synchronous line group to be used by BTAM at OPEN time. 
For example, a line group comprised of 5 lines coded as: 
MODELST=(,1,,3,) would assign a code of 1 to line 2, 3 to line 
4 and 0 (default) to lines 1, 3 and 5. CICS/DOS/VS does not 
support the use of codes 4, 5, 6, and 7. A more detailed 
explanation of this operand is given in DOS/VS Basic 
Telecommunications Access Method . If converting from 
CICS/DOS/VS to CICS/OS/VS, this operand must be recoded to 
MODE. 


MONDLY=10|number 

specifies the number of mark characters to be sent to a 
Teletypewriter (WTC only) when this terminal is not equipped 
with the Motor-On optional feature. The default is MONDLY=10. 


RETRY-number 

specifies the number of retries (0 to 15) by BTAM for 
recoverable errors which occur on I/O operations for binary 
synchronous communication. The default is RETRY=7. 


switch=no|yes 

specifies the type of line connection between the system and 
the remote device. The default is SWITCH=NO. 

NO 

indicates that the line connection is dedicated. 
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YES 


indicates that the line connection is through a switched 
network. 


TERMTST=NOI YES 

specifies whether the online terminal test facility is to be 
used. The default is TERMTST=NO. 

NO 

indicates that online terminal test is not to be used. 

YES 

indicates that online terminal test is to be used. 

A more detailed explanation of this operand is given in DOS/VS 
Basic Telecommunications Access Method . For CICS/OS/VS, the 
online terminal test facility is specified through the ERROPT=T 
operand. 


For CICS/OS/VS only 


APPENDG=xx 

applies when DEVICE=7770 is specified. This operand is used to 
specify a two-character alphameric suffix for the 7770 channel 
end/abnormal end appendage routine. The suffix specified must 
be in the range WA to Z9 and must be the same suffix as 
specified in the CAA operand of the DFHSG PROGRAM=CSO macro 
instruction. 


DDNAME=name 

supplies the name of the data definition (DD) statement 
associated with a particular data set (line group). If this 
operand is omitted, the DSCNAME becomes the DDNAME• 


FLNNAME=name 

specifies, for CICS/OS/VS only, the name of the first 
communication line entry that is defined by the DFHTCT 
TYPE=LINE macro instruction for local 2260s. 


| MACRF=R|W 

specifies how access to the BTAM line group or to sequential 
devices is to be gained. 

R 

indicates the READ macro instruction. 

W 

indicates the WRITE macro instruction. 

The default for BTAM line groups is MACRF=(R,W); the OPEN 
option for BTAM line groups defaults to input. For sequential 
devices (other than card reader and line printer), MACRF-R or 
MACRF=W must be specified. The default is MACRF=R for a card 
reader and MACRF=W for a line printer. 
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| MODE=mode of communication 

specifies the mode of communication for a binary synchronous 
line group. Note that since CICS/VS does not support the IBC 
parameter described in OS/VS Basic Telecommunications Access 
Method , a leading comma must be used. 

CNTRL 

should be specified if the central computer is to be given 
control when contention occurs on a point-to-point 
nonswitched line. It should be omitted if the remote 
station is to be given control. 

A 

specifies that communications are to be through the 2701 
Data Adapter Unites Dual Communication Interface A. 

B 

specifies that communications are to be through the 2701s 
Dual Communication Interface B. This parameter must not be 
coded if this feature is not present on the 2701. 

A 

specifies use of the transmission code A for 2701 Data 
Adapter Unit Dual Code Feature. 

B 

specifies use of the transmission code designated by Code B 
for 2701 Dual Code Feature. This parameter must not be 
coded if this feature is not present on the 2701. 


| OPTCD=code 

specifies the optional fields for the TCAM work unit. The W 
specifies that, for input, the name of the source of each 
message is to be placed in an eight-byte origin field in the 
work area. For output, it specifies that TCAM expects the name 
of the destination of the message to be placed in an eight-byte 
destination field in the work area before a TCAM WRITE macro 
instruction is executed. OPTCD=W must be specified for both 
the input and output macro instruction. 

U 

specifies that the work unit to be handled is either a 
message or a message segment which is not a record. If U 
is omitted, the work unit is assumed to be a record. 


C 

specifies that a one-byte field in the work area, called 
the position field, indicates whether the work unit being 
handled is the first, an intermediate, or the last segment 
of the message, and, on input, whether a record delimiter 
has been detected in the data. 

For further information concerning the OPTCD operand, see the 
OS/VS TCAM Application Programmer's Guide . 


| RECFM=record-format 

specifies, for sequential data sets, the record format for the 
DCB. The default is RECFM=U- 

U 

| indicates undefined records. This option must be specified 

| for DEVICE=1403 or 3211. 
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F 


indicates fixed-length records. 

V 

indicates variable-length records. 

If this operand is omitted,, the record format can be specified 
in the data definition (DD) statement associated with the 
sequential data set. 


SYNAD=symbolic-name 

is applicable only to CICS/OS/VS with TCAM and specifies the 
address of a subroutine which is to be given control if message 
processing is used; the work unit is larger than the work area, 
and OPTCD=C is not specified. 

For input queues, a user-written SYNAD routine can be specified 
for which an EXTRN is generated. If SYNAD is not specified, a 
CICS/OS/VS generated SYNAD routine is provided. If CICS/OS/VS 
SYNAD is used and the exit occurs: 

1. Message DFH4000 is issued. 

2. The DCB is closed. 

3. The DCB is reopened. 

4. Data is truncated to the specified block size and is passed 
to the CICS/OS/VS application program. 


TERMINAL TYPES — DFHTCT TYPE=TERMINAL 

The types of terminals in the system are described to CICS/VS by the 
DFHTCT TYPE=TERMINAL macro instruction. The expansion of this macro 
instruction is the terminal control table terminal entry (TCTTE). 

The VTAM terminal entries must be specified contiguously, and must 
end with an entry specifying LASTTRM=VTAM. They must be preceded by any 
BTAM and TCAM terminal entries. The DFHTCT TYPE=TYPE=LINE and DFHTCT 
| TYPE=SDSCI macros do not apply to VTAM terminal entries. For VTAM 
| logical units, the VTAM BIND area is generated from the TCTTE. This 
| includes values for the RUSIZE and BUFFER parameters. 

For BTAM or TCAM terminal entries, the terminal definitions must 
immediately follow the corresponding line entry (DFHTCT TYPE=LINE). The 
sequential terminals (TRMTYPE=CRLP,DISK, TAPE) support only one entry 
each. 

A DFHTCT TYPE= TERMINAL macro instruction must be generated for each 
terminal on a line. For single-dropped and multidropped terminals on 
nonswitched lines, the DFHTCT TYPE=TERMINAL macro instruction must 
immediately follow the DFHTCT TYPE=LINE macro instruction. The DFHTCT 
TYPE=TERMINAL macro instruction entries must be contiguous for 
multidropped terminals on nonswitched lines and for terminals in a 
terminal pool on switched lines. For Teletypewriters (WTC only), one 
DFHTCT TYPE=LINE and one DFHTCT TYPE= TERMINAL macro instruction should 
be specified for each line attachment in the system. 

The following operands can be used in the DFHTCT TYPE=TERMINAL macro 
instruction. Note that the optional operands for this macro are 
arranged in the following order in the syntax display: 
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• Operands which apply to BTAM f TCAM, and VTAM 

• Non-VTAM operands 

• Operands which may be used with VTAM or TCAM SNA devices 

• VTAM-only operands 

to allow the user to identify the operands which apply to his own system 
on an access method basis. The descriptions of the optional operands 
are presented alphabetically after the description of the required 
operands. 
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[label 


t__— 
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DFHTCT 


TYPE=TERMINAL | 

,LASTTRM={LINE|POOL|VTAM} j 

,TRMIDNT=name j 

.TRMTYPE={ type specified in TYPE=L1NE Itype} j 

£.ACCMETH={ method specified in TYPE=LINE IVTAM> 3 | 

E,ALTPGE=(lines,columns)] j 

(,ALTSCRN=(lines,columns)3 j 

E,BUFFER=E0|buffer-size3] j 

[ f DEFSCRN= (lines,columns)3 j 

E,FEATURE=(feature(,feature3,...)3 j 

C,HF=£NO|YES) 3 | 

E,0PERID=id3 | 

(,OPERPRI=code3 | 

[,OPERSEC={11(number,number..) 3 3 j 

£,PGESIZE=(lines,columns)3 | 

I,PGESTAT={AUTOPAGE|PAGE}3 j 

(.TCTUAL={ number-s pecified-in-TYPE=LINE I number)3 j 

£,TIOAL=£(value(value-1,value-2)3 3 | 

£,TRANSID=name3 j 

£,TRMMODL=£ number-specified-in-TYPE=LINE Inumber| j 

character)3 | 

t, TRMPRTY= £ () | number 3 3 j 

£,TRMSTAT=(status £,status 3,3 3 j 

£,VF=£NO|YES33 j 

Non-VTAM | 

£.CLASS=£ class-specified-in-TYPE=LINE I(££CONVIBATCH33 | 
£,{VIDEO|HARDCOPYJ AUDIO)3 £,BISYNC) j 

£,INQUIRY3)3 j 

£.COMPAT= £ NOI(characters,lines,device,model, j 

.FASTER COMPAT))) | 

£,DISMSG=name3 j 

£,LPLEN= £1321value 3 3 j 

E,LVUNIT=number) | 

£,POLLPOS=number) j 

£,STN2980=number3 j 

E,TAB2980=£0|value}) 1 

E,TRMADDR= £ address|name 3 3 j 

VTAM and TCAM SNA only | 

E,BMSFEAT=(OBFMT,OBOPID,FMHPARM,NOROUTE,NOROUTEALL)3 | 

E,LDC=£listname|(aaC-nnn],bb£=nnn],cc E=nnn3,...))) j 
f.NETNAME=£ name specified in TRMIDNT Iname}) S 

E,SESTYPE=session-type3 | 

VTAM only j 

E,ALTPRT=(labelE.COPY))3 | 

£.BRACKET=£ YES I NO 3 3 j 

£.CHNASSY= £NOl YES)3 | 

£,C0NNECT=AUT03 j 

E,GMMSG=£NO|YES)3 | 

E,LOGMODE=name3 j 

f,PIPELN=( LAST |POOL)3 | 

E,PRINTTO=(label£,COPY))3 | 

£,RELREQ=£(NO,...)|(YES,...)|(...,NO)1(...,YES)33 j 

£,RUSIZE=£256jvalue}] j 

£,TASKNO=number3 j 
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Note : Questions regarding terminal control table parameter selections 

may be clarified by referring to the TCT Configurator at the beginning 
of this section. 

label 

provides a one- to eight-character name for the DFHTCT 
TYPE-TERMINAL macro being generated and must be specified on 
the DFHTCT TYPE=TERMINAL macro which identifies the first 
terminal in a pool of switched terminals or local 3270s, and on 
a 3270 printer referenced by PRINTTO or ALTPRT (see these 
operands below). It is optional otherwise. If used in this 
manner, "label" should be the same as that used in the POOLADR 
operand of DFHTCT TYPE=LINE. 


TYPE=TERMINAL 

specifies the terminals for the system. 


LASTTRM=LINE|POOL|VTAM 

indicates a "last terminal" condition. 

LINE 

applies to BTAM and BGAM nonswitched line processing 
(except local 3270). 


POOL 

applies to BTAM switched-line processing and the local 3270 
Information Display System (non-VTAM). It must be 
specified to identify the last terminal in the pool. 


VTAM 

must be coded on the last TCTTE in the VTAM group. An 
error MNOTE is generated if any VTAM TCTTEs are encountered 
after this parameter has been specified for a terminal 
entry. 

When using TCAM, this parameter indicates the last terminal 
condition as follows: 

1. LASTTRM=LINE if POOL=YES has not been specified. 

2. LASTTRM= POOL for the last terminal in the pool if POOL=YES 
has been specified. 


TRMIDNT=name 

supplies a unique four-character symbolic identification to 
each terminal. The TRMIDNT parameter and the destination 
identification in the destination control table, when 
applicable to terminal destinations, must be the same. The 
identification supplied will be left-justified and padded with 
blanks to four characters if less than four characters are 
supplied. This is necessary because the system always searches 
for a four-character match when searching tables. The default 
for DEVICE=CONSOLE is CNSL (CICS/DOS/VS only). 


TRMTYPE and SESTYPE 

Support for logical units is generated by specifying the 
appropriate TRMTYPE/SESTYPE combinations described in the 
following table. For BTAM and TCAM devices, the TRMTYPE 
operand can be used to specify the terminal type: 
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1. If the terminal type has not already been specified in the 
DFHTCT TYPE=LINE macro instruction, or 

2. To override the type specified in that macro instruction. 

The parameters are those described for the TRMTYPE operand of 
the DFHTCT TYPE=LINE macro- 


r~ 

Terminal 

Subsystem 

r 

1 

1 

Logical Unit 

r" - - - ■ - ■ 

| TRMTYPE= 

1 

i 

i 

SESTYPE= 

*1 

r* 


* r 


I* 





3270 

i 

3270 - Display station 

| 3275, 

i 

- 




i 

- Display station 

| 3277, or L3277 

i 





i 

- Printer 

| 3284, or L3284 

i 

- 




i 

- Printer 

I 3286, or L3286 

i 

- 




i 


| (also generates! 





i 


| 3288) 

i 





i 

Logical unit type 2 3 

| LUTYPE2 

i 

- 




i 

Logical unit type 3 3 

| LUTYPE3 

i 

- 




i 

SCS printer 

| SCSPRT 

i 

l 

— 



3600 

i 

i 

3601 

| 3600 

1 

i 

- 




i 

3614 

| 3614 

i 

- 




i 

t 

Pipeline 

| 3600 

i 

I 

PIPELN 



3650 s - 

1 

i 

Pipeline 

| 3650 

i 

i 

PIPELN 




i 

Host-conversational 

| 3650 

i 

3270 




i 

(3270) 


l 





i 

Host-conversational 

| 3650 

i 

3653 




i 

(3653) 


i 






Interpreter 

| 3650 

i 

USERPROG 3 




i 

Host Command Processor 

| 3650 

i 

USERPROG 3 




i 

i 

(HCP) 


i 




3767 

1 

i 

Interactive (flip-flop 

| 3767,37671, 

i 

i 

- 




i 

mode) 

j or INTLU 

i 





i 

(contention 

| 3767C 

i 

- 




i 

i 

mode) 


i 




3770 

1 

i 

Interactive (f1ip-flop 

J 37701, 

i 

i 

- 




i 

mode) 

I or INTLU 

i 





i 

(contention 

| 3770C 

i 

- 




i 

mode) 


i 





i 

Batch (flip-flop mode) 

| 3770,3770B 

i 

- 




i 


| or BCHLU 

i 





i 

Full Function 

| 3770 or 3770B 

i 

USERPROG 




i 

t 

Batch Data Interchange 

| 3770 

i 

1 

BATCHDI 



3790 

I 

i 

Full Function 

| 3790 

1 

i 

USERPROG 




i 

Inquiry 

| 3790 

i 

- 




i 

Batch Data Interchange 

| 3790 

i 

BATCHDI 




i 

3270-display 3 

| 3790 

i 

3277CM 




i 


| LUTYPE2 

i 

- 




i 

3270-printer 3 

j 3790 

i 

3284CMJ3286CM 




i 


| LUTYPE3 

i 

- 




i 

SCS printer 

| 3790 

i 

SCSPRT 




i 


j SCSPRT 

i 

- 


L. 

■ 

- L. 





-J 


Notes: 


1- The 3650 subsystem is not supported under TCAM. 
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2. The 3650 interpreter logical unit is generated with BRACKET=YES, 
and the 3650 host command processor logical unit is generated with 
BRACKET=NO. 

| 3. The table at the end of Appendix D gives some of the possible 

j configurations for new and existing 3270 devices, some of which may 

| be used to provide alternate screen size support- TRMTYPE and 

| SESTYPE specifications are given for local, BSC, and SDLC 

| connections. LUTYPE2 logical units are those defined by SNA, which 

j accept a 3270-display data stream. LUTYPE3 logical units are those 

| defined by SNA, which accept a data stream similar to that for a 

| 3270 printer. TRMTYPE=LUTYPE2 may be specified for 3790 3270- 

| compatible logical units, and TRMTYPE=LUTYPE3 may be used for 3270 

| printer logical units. 


| ACCMETH=method 

indicates which access method is to be used for this TCTTE. 

| The default is the access method specified in the ACCMETH 

| operand in DFHTCT TYPE=LINE. 

VTAM 

indicates that a Virtual Telecommunications Access Method 
TCTTE is to be created. 


I ALTPGE=(lines,columns) 

j indicates the page size to be used by BMS for this terminal 

I entry when ALTSCRN has been selected as the screen size. The 

| default is the value specified in ALTSCRN. 

ALTPRT=(labelC,COPY]) 

specifies an alternative printer to be used only if the primary 
printer (specified in PRINTTO) is unavailable. The * label* 
parameter functions as for PRINTTO. PRINTTO must always be 
specified if ALTPRT is specified; otherwise ALTPRT is ignored. 

The specification of COPY in either PRINTTO OR ALTPRT means 
that CICS/VS will use the hardware ■COPY* feature of the 3270 
to perform the print, unless a task is currently attached to 
the display. If only one of the PRINTTO and ALTPRT printers is 
| on the same remote 3270 control unit as the display, this 

should be the PRINTTO printer, because this one will always be 
used if possible. FEATURE=COPY need not be specified for the 
screen from which the printout is requested, because this is 
implied by the COPY option on PRINTTO or ALTPRT. 

COPY must only be specified in PRINTTO or ALTPRT if the display 
(the terminal for which PRINTTO or ALTPRT are specified) and 
the printer (the terminal specified by PRINTTO or ALTPRT) are 
| on the same 3270 control unit. If COPY is specified and the 

display and printer are on different control units, either the 
COPY option may fail and an error condition be raised or, if 
the display device address is valid for the printer’s control 
unit, copying might be performed from a different display. For 
a 3270 compatibility mode display, the COPY command is invalid 
and will be ignored if used. 

| Note : In a networking environment, if the 3270 control unit is 

1 connected to a TCAM system in one domain and if a CICS/VS 

I system in another domain has access to the control unit via 

j VTAM, the COPY parameter must not be specified for the displays 

I on that control unit, because the hardware copy address is not 

I available to CICS/VS. 
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It is unnecessary to specify FEATURE=PRINT in the DFHTCT 
Type=TERMINAL instruction for a printer specified in either 
PRINTTO or ALTPRT, because this is implicit when these operands 
are specified. 

If PRINTTO and ALTPRT are omitted, or the devices are 
unavailable, the "unavailable printer" error condition will 
result. This implies that the printer (if specified) is in one 
of the following conditions: 

• Out of service 

• Task currently attached 

• Currently busy on a previous operation 

• Intervention required. 

Further information is given in the section on node error 
programs in Chapter 4.3 of this manual. 


j ALTSCRN=(lines,columns) 

| defines the 3270 screen size to be used for a transaction that 

| has SCRNSZE=ALTERNATE specified in DFHPCT TYPE=ENTRY. The 

j default is the value specified in the DEFSCRN operand. The 

j values that can be specified are: 

I 

| 3276-1,3278-1 

J 3276-2,3278-2 

| 3276-3,3278-3 

| 3276-4,3278-4 

s 

j Note that there is no validity checking performed on the screen 

j size selected, and that incorrect sizes may lead to 

I unpredictable results. 

| For SNA devices (LUTYPE2 and LUTYPE3), it is possible to 

j specify DEFSCRN with the same value as in ALTSCRN (that is, 

j both with a screen size of 43,80). In this case, all 

j transactions can run using the ALTSCRN size, and 

| SCRNSZE=ALTERNATE need not be specified in DFHPCT. 

J For non-SNA 3287 and 3289 printers, the sizes depend on the 

j feature ordered, not on the model number. 

| For SNA printers, there are no features, and any two sizes can 

j be specified from the "valid" list. 


(12,80) 

(24.80) 

(32.80) 

(43.80) 


| BMSFEAT=feature 

indicates which BMS features will be used for this TCTTE. 

OBFMT 

indicates that BMS is to support outboard formatting for 
this terminal. The macro instruction should restrict this 
parameter to 3650 logical units which are capable of 
supporting outboard formatting. 
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OBOPID 

indicates that the outboard operator identifiers will be 
used by CICS/VS in order to support the BMS routing 
facilities required for this terminal. This option only 
applies to the 3790 and 3770 batch data interchange 
(SESTYPE=BATCHDI) logical units. 

FMHPARM 

indicates that BMS is to accept user-supplied parameters 
for inclusion in the FMH built by BMS. The macro 
instruction should restrict this parameter to 3650 logical 
units. 

NOROUTE 

indicates that BMS is not to produce routed data for this 
terminal. This is the required specification for 3653 
terminals. 

NOROUTEALL 

indicates that BMS is not to include this terminal in the 
| list of terminals to receive data in response to a BMS 

| route request to all devices. This operand is never 

required, but may be specified for any terminal. 

Note : BMSFEAT does not apply to the 3790 inquiry logical 

unit, because there is no BMS support for this type of 
logical unit. 


BRACKET=YES|NO 

specifies whether bracket protocol is to be enforced for this 
logical unit. 

YES 

indicates that bracket protocol is to be enforced. This 
option is required for the 3790 inquiry and full function 
logical units. (BRACKET=YES will be forced for 3270 
compatibility mode sessions if not specified explicitly.) 
BRACKET=YES must also be specified if any of the 
interactive logical unit parameters or batch logical unit 
parameters are specified in the TRMTYPE= operand. 

NO 

indicates that bracket protocol is not to be enforced. 
BRACKET-NO must be specified for a 3614 logical unit and 
the 3650 Host Command Processor (HCP) session. 

Note : For a VTAM 3270, the entire session constitutes a 
bracket. Therefore, the BRACKET operand will be ignored on the 
DFHTCT TYPE=TERMINAL macro. 


BUFFER=buffer-size 

specifies the presence and size of the receive buffer for the 
| indicated terminals and logical units. The following buffer 

sizes should be specified which correspond to the related 
hardware features installed. 
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Device buffer sizes 


Buffer Size 

2740 Model 2 

120 

248 

440 

2770 


Feature 


1499 - Buffer Receive 

1495 - Buffer Expansion 

1496 - Buffer Expansion 


128 

256 

512 


(standard) 

1490 - Buffer Expansion 

1491 - Buffer Expansion, additional 


3780 

512 


(standard) 


2780 


MULTIREC 5010 - Multiple Record Transmission 

Note : BUFFER=MULTIREC should be specified for the 2780 with 

multiple record transmission. 


The default value is BUFFER=120 for the 2740 Model 2 # 
BUFFER-128 for the 2770, BUFFER=512 for the 2780 and BUFFER=0 
for other devices* 


For 3600 BSC devices, BUFFER represents the maximum data length 
which the work station may receive. The value specified must 
not be greater than the size of the host read buffers of either 
the 3601 or of the work station. 

The unit of transmission from CICS/VS to the BSC 3601 is a 
segment. If an application program issues a WRITE for a message 
longer than the value in BUFFER, CICS/VS will break the message 
down into as many segments as necessary. The length of each 
segment (except the last) is equal to the value of BUFFER. The 
length of the last or only segment (in the case of a single 
segment message) is the length of the data still to be sent. 

Logical unit buffer sizes 

Buffer size represents the maximum data length that the logical 
unit can receive, and should be equal to the capability of the 
appropriate device. However, line quality considerations may 
dictate a smaller value, for devices with large buffers, than 
the actual buffer size. For further information, refer to the 
appropriate hardware component description manual. 

If a longer message is presented by an application program to 
be sent by CICS/VS, it is broken into as many request units as 
necessary. Each request unit has a maximum length equal to the 
buffer size specified. This length includes the FMH (if 
present) in the first request unit of the message. For 
recovery purposes, the complete message (that is, chain of 
request units) is treated as the unit of recovery. 

For 3270 compatibility mode logical units, the recommended 
buffer size values are: 
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256 

1536 


TRMTYPE=SCSPRT 
TRMTYPE-LUTYPE2 

(or TRMTYPE=3790,SESTYPE= 3277CM) 

TRMTYPE=LUTYPE3 256 

(or TRMTYPE=379 0,SESTYPE=3284CM) 

For LUTYPEs 2, 3, and 6 the value specified in BUFFER will be 
transmitted to the connected logical unit. This value may be 
adjusted slightly by CICS/VS according to the value specified, 
because the value must be transmitted in an architected form. 
Thus, the value may be rounded down by CICS/VS before being 
transmitted. 

For LUTYPE6 logical units (DFHSG PROGRAM=TCP,VTAMDEV=LUTYPE6), 
a buffer size of zero should be specified or allowed to 
default. 

If zero is specified or assumed by default, no chaining takes 
place. The data sent is the same size as presented to CICS/VS 
by the application program. 

Note : For 3270 logical units, BUFFER will always be set to 0 

by CICS/VS to prevent output chaining, which is not needed for 
these logical units. 


CHNASSY=YES|NO 

specifies whether or not chains are to be assembled on input by 
terminal control before any processing is performed on any part 
of the chain. The default is NO. This operand may not be 
specified for 3270 logical units. CHNASSY=YES will be forced 
for 3270 compatibility mode logical units. 

YES 

indicates that any input TIOA received by an application 
program from this logical unit will contain a complete 
chain. 

NO 

indicates that any input TIOA received by an application 
program from this logical unit will contain one request 
unit (RU). 


| CLASS=class 

indicates the device classification. The parameters are the 
same as those which may be specified for the CLASS operand of 
| the DFHTCT TYPE=LINE macro instruction, with the addition of 

| CLASS=INQUIRY which indicates, for 2770, 3770, and 3780 BSC 

I terminals, that CICS/VS will transmit batch data in inquiry 

j mode. That is, only two blocks of data will be transmitted at 

j a time, followed by a line reset. The default is the 

specification made in the CLASS parameter of DFHTCT TYPE=LINE. 
This operand does not apply when CONSOLE is specified as a 
device, or to devices connected through VTAM; it is required in 
either the TYPE=LINE or TYPE=TERMINAL macro for all other 
devices. 


j COMPAT=NO|characters|lines J device|model|Faster Compat 

indicates that the 2260/2265 terminal or 1053 printer specified 
in the "device" parameter is to be simulated on the 3270 
Information Display System. The keyword parameters are 
positional and must be replaced by a comma if they are omitted. 
The default is C0MPAT=N0. 
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2260 compatibility is not available for 3270s operating through 
VTAM or for 3270 compatibility mode logical units. In such 
cases this operand will be ignored and a non-error MNOTE will 
be produced. 

NO 

indicates that 2260/2265 or 1053 simulation is not 
required. 

characters 

specifies the screen size of the 2260/2265 terminal. The 
applicable parameters are 240, 480, and 960. 

lines 

specifies the number of lines applicable to the 2260/2265 
terminal or to insert new line (NL) symbols into the 
3284/3286 printer output data stream where NL symbols are 
not provided by the user in the output data stream. 
Applicable parameter values are 6, 12, and 15. The default 
value for a 960-character screen is 12. 

device 

specifies either a 1053, 2260, L2260, or 2265 terminal. 

The default is 2260. Note that the specification 
COMPAT^(960,15) results in an error condition because the 
2260 (assumed by default) cannot support 15 lines. 

model 

specifies a model number for the 2260 terminal being 
simulated. This parameter provides an interface for any 
user-written application programs which currently test the 
TCTTEMN field before building device-dependent 2260 data 
streams. Any one character value may be specified for the 
model number. If a value is not provided, a value of zero 
(*F0 f ) is used. 


Model 


Specification 

Screen 

Format 

TRMMODL=A 

6X40 

2260 

TRMMODL=B 

12X40 

2260 

TRMMODL=C 

12X80 

2260 

TRMMODL=D 

15X64 

2265 

TRMMODL=E 

12X80 

2265 


FASTER COMPAT 

specifies FASTER 2260 Compatibility support for the 3270 
terminal. 


Example s s COMPAT=(960,12,1053,C,F2260) 

COMPAT=(240,6,2260,A,F2260) 

For further information concerning the use of the COMPAT 
operand, see the section "2260 Compatibility for the 3270" in 
Chapter 5.5 of this manual. 


CONNECT=AUTO 

| indicates that CICS/VS is to issue a VTAM SIMLOGON macro 

instruction automatically for this logical unit when CICS/VS is 
initialized. If this operand is not specified, this logical 
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unit: will not be logged on to CICS/VS at initialization and 
must be logged on by: 

• The logical unit itself 

• The master terminal operator, by acquiring the logical unit 

• The VTAM network operator 

• VTAM (automatically) via START options 

• Automatic task initiation (ATI). 

This operand must not be specified for 3790 inquiry logical 
units. 

Note : If the VTAM macro has ISTATUS=INACTIVE, the SIMLOGON 

issued during CICS/VS initialization will fail, and a CSMT 
ACQUIRE command will be required before the logical unit can be 
used by CICS/VS. 


DEFSCRN=(lines,columns) 

defines the 3270 screen size or page size to be used on this 
device when attached to a transaction for which SCRNSZE=DEFAULT 
has been defined in DFHPCT TYPE=ENTRY. The default is the 
value associated with the appropriate option in the TRMMODL 
operand. 

The values that may be specified in the DEFSCRN operand are: 


3276-1, 3278-1 12,40 
3276-2, 3278-2 24,80 
3276-3, 3278-3 24,80 
3276-4, 3278-4 24,80 

For LUTYPE2 and 3 logical units, the value specified in DEFSCRN 
may be the same as that used in the ALTSCRN operand. 


DISMSG=name 

applies only to CICS/OS/VS support for World Trade Teletype 
terminals (TRMTYPE=TLX). "name" indicates the label of the 
DFHTCT TYPE=TLXMSG macro, which identifies the message text 
that is to be written to the terminal when a DFHTC 
TYPE=DISCONNECT request is issued. If the DISMSG operand is 
specified, a DFHTCT TYPE= TLXMSG macro with the corresponding 
name must be coded. If the operand is not specified, the 
message written in response to a DFHTC TYPE=DISCONNECT request 
is "DFH2535 DISCONNECT REQUESTED". 


| FEATURE 3 f eature 

specifies the applicable features for the 3270 Information 
Display System and corresponding 3284 Printer Model 3 on the 
3275 Display Station, the 2980 General Banking Terminal System, 
the 2770 Data Communication system, the 2780 Data Transmission 
Terminal, the 3600 BSC Finance Communication System, the 
System/3, and the System/7. 

PTRADAPT 

for the 3275: specifies the Printer Adapter feature and 
corresponding 3284 Printer Model 3 on the 3275 Display 
Station. This feature makes the 3284 eligible for print 
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requests through the Program Access key from the host 3275. 
A separate DFHTCT TYPE=TERMINAL macro instruction cannot be 
coded for the 3284 Printer Model 3, because this printer 
shares the buffer of the 3275 Display Station. 

for LUTYPE2 logical units: specifies that for print 
requests initiated by the PRINT key or by a DFHTC 
TYPE=PRINT macro, printer allocation will be handled by the 
3790, or by the 3274 or 3276 according to the print 
authorization matrix for both VTAM and non-VTAM 
attachments. Further, 3270 printers attached to the same 
3790 are available for print requests sent to the 3270- 
display logical unit by a terminal control print request or 
initiated by the operator. If FEATURE=PTRADAPT is not 
specified, printer allocation is determined by the PRINTTO 
and ALTPRT parameters. 

Note : If output is created on the screen by DFHBMS or 

DFHMSD macros with CTRL=PRINT, by BMS requests with the 
NLEOM option, or by the CMSG command, the contents of the 
screen are automatically copied to a 3270 printer, whether 
the Program Access key was hit or not. 

SELCTPEN 

specifies the Selector Pen feature for a 3270 display. 
AUDALARM 

specifies the Audible Alarm feature for a 3270 or for a 
3270 display/printer attached to a 3651 controller. 


COPY 

specifies that the Copy Feature for a 3270 display or 
printer is included in the 3270 control unit. This option 
should not be specified for 3270 compatibility mode logical 
units, and will be ignored if specified. 

DCKYBD 

specifies the typewriter keyboard and/or operator console 
keyboard for a 3270 display. Both uppercase and lowercase 
data can be transmitted with either of these keyboards. 

UCTRAN 

specifies translation of lowercase data to uppercase in 
3270, 3767, and 3770 SDLC input data streams. If UCTRAN is 
specified, the EBCDIC and/or ASCII parameters must also be 
specified in the UCTRAN operand of the DFHSG PROGRAM=TCP 
macro instruction. Only UCTRAN=EBCDIC is valid for 3270 
logical units. Translation can be overridden by the 
application program for specific READ requests. 


PRINT 

must be specified for BTAM-supported 3270 printers that are 
eligible to receive print requests. This feature makes the 
3270 printer eligible for print requests by means of the 
Program Access key from a 3270 display. In order to 
support print requests from a 3270 display, the remote 3270 
control unit must have the copy feature (see COPY option 
above). For local 3270"s, all terminal control table 
terminal entries for devices attached to the same local 
3270 control unit must be generated on the same terminal 
control table SDSCI/LINE pair and a separate SDSCI/LINE 
pair must be generated for each local control unit. (See 
the PRINT operand in DFHSIT.) 
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BUFEXP 

specifies the Buffer Expansion feature (RPQ835503) for the 
2980 General Banking Terminal System. Applicable only to 
the first terminal entry of a control group, the BUFEXP 
parameter increases the station buffer size to 96 
characters. 

TRANSPARENCY 

specifies that terminal data is not to be translated on a 
read or write, allowing the sending or receiving of all 256 
bit combinations in a byte. This applies to the 2770, 

2780, S/3, S/370, and S/7BSCA. 

3270E 

indicates that the device to be used is one of the extended 
3270 range (3276, 3278, 3287 or 3289). This option may 
not be specified for a 3287 printer attached to a 3271 or 
3272 control unit. 

The following options may be specified when the 3270 Extended 
Character Set feature is installed. Further information can be 
found in the 3270 Information Display System Component 
Description manual. 

APLKYBD 

indicates that the APL keyboard feature is to be used. 
APLTEXT 

indicates that the APL text feature is to be used. This 
option may not be specified for a 3288 printer (with or 
without the TEXTPRINT option, below. The APLTEXT feature 
is used in conjunction with the TEXTKYBD and APLKYBD 
options. 

TEXTKYBD 

indicates that the text-keyboard feature is to be used. 
TEXTPRINT 

indicates that the text-print feature is to be used on a 
3288 printer. This option may be used in conjunction with 
the 3270E option to indicate that the text-print feature 
will be used on a 3289 printer. 

For further information on the use of the FEATURE operand with 
2260 displays, se£ the section "2260 Compatibility for the 
3270" in Chapter 5.5. 


GMMSG=NO|YES 

indicates whether the CICS/VS "good morning" sign-on message 
will be displayed when the logical unit is signed on to VTAM. 
The default is GMMSG=NO. 

NO 

indicates that the "good morning" message is not required. 

YES 

indicates that the "good morning" sign-on message is to be 
displayed. This option causes transaction CSGM to be 
invoked, which runs when the OPNDST exit is successful at 
sign-on. 


Chapter 3.2. 


DFHTCT TYPE=TERMINAL 


285 





| LDC=1istname|mnemonic 

| indicates that this TCTTE points to a list of logical device 

j codes (LDCs). The list is used to specify which LDCs are valid 

for this logical unit and, optionally, which device \ 
characteristics are valid for each LDC. The first LDC 
generated in this list is the default when CICS/VS must choose 
a default LDC for a logical unit. 

| Note : This operand only applies to 3601, 3770 batch, and 3770 

and 3790 batch data interchange logical units. 

listname 

| specifies the name of the local LDC list or extended local 

LDC list to be associated with this logical unit. (This 
LDC list is generated by a DFHTCT TYPE=LDCLIST macro 
instruction or by a series of DFHTCT TYPE=LDC macros for 
the extended local LDC list.) 

(aa(=nnn),bb(=nnnl,...) 

is used to generate a local LDC list that applies only to 
this logical unit. 

aa,bb,... 

is a list of two-character mnemonic LDCs. If BMS uses 
these LDC mnemonics, each LDC mnemonic specified must have 
a corresponding entry in an LDC list created by a DFHTCT 
TYPE=LDC macro instruction. 

nnn 

is a decimal value from 1 through 255 associated with this 
LDC. If no value is coded, the system default value from 
the table defined by DFHTCT TYPE=LDC is used. This value 
need not be specified for a batch logical unit, but if it 
is, it must correspond to the device. LDC values for 
devices attached to a batch logical unit are listed under 
the LDC parameter of the DFHTCT TYPE=LDC macro. 


LOGMODE=name 

indicates a logmode name in the logon mode table that has been 
set up for use by this logical unit. This operand allows the 
user to override the BIND image provided by CICS/VS for the 
logical unit being generated. For further information, refer 
to the appropriate CICS/VS subsystem guide. 


| LPLEN=value 

controls the length of the print line for SAM output line 
printers. If no NL symbols are found in a segmented write, the 
print line length is the LPLEN value. The default is LPLEN=132 
except for the CONSOLE device (CICS/DOS/VS only) where the 
default is 80. 


LVUNIT=number 

specifies a decimal number from 1 to n which is used to 
identify the local video unit. For local 2260 or local 3270 
(BTAM-support only), n is a maximum of 32 (use of Assembler D 
restricts n to a maximum of 31). This operand is applicable 
only when TRMTYPE=L2260, TRMTYPE=L3277 (BTAM-support only), 
TRMTYPE=L3284 (BTAM-support only), or TRMTYPE=L3286 (BTAM- 
support only) is specified. 

For CICS/DOS/VS, the LVUNIT specification indicates the local 
video unit 1 * s relative position in the corresponding DFHTCT 
TYPE=SDSCI, LINELST=parameter specification. For CICS/OS/VS, 
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the LVUNIT specification indicates the local video unit’s 
relative position in the concatenation of data definition (DD) 
statements for the corresponding DFHTCT TYPE=SDSCI 
specification. 


NETNAME=n ame 

| indicates a one- to eight-character symbolic network name for 

the logical unit as it is known throughout the network. The 
name is supplied to VTAM system definition and is used to build 
the node initialization block (NIB) that represents this TCTTE 
in CICS/VS. When not coded for a VTAM TCTTE, the default is 
the logical unit's identification padded with 4 blanks. (A 
non-error MNOTE is issued.) NETNAME must be specified for 
3614s. For TCAM devices, the name must be the same as that 
used in the TCAM TERMINAL macro. 


OPERID=id 

J specifies the three-character operator identification code to 

be used when CICS/VS signs on. 


OPERPRI=code 

specifies the operator priority code to be used when CICS/VS 
signs on. The code may be any value from 0 through 255. 


OPERSEC=number 

| specifies the security key for this TCTTE if sign-on is not 

| performed by the terminal operator. The security key comprises 

j one or decimal values from 1 through 24. The default is 1. 

Note : For the 3614, the OPERSEC operand allows a signed-on 

condition for a 3614 logical unit to be generated. The OPERSEC 
operand must be specified for a 3614 unless the 3614 
application program has a security key of 1. 

For the 3600 and 3650, the OPERID, OPERSEC and OPERPRI operands are used 
to specify the CICS/VS operator sign-on parameters to be used with this 
terminal. These operands can only be specified if SESTYPE=PIPELINE, 
3270, or USERPROG. 

The above restrictions are enforced when the CICS/VS terminal control 
table is created. These operands are not applicable when defining a 
3650 host command processor (HCP) logical unit. 


PGESIZE=lines,columns 

| indicates the default page size for this terminal. If the 

j DEFSCRN operand is specified in this macro for a 3270, the 

j value specified in this operand supplies the page size to be 

f used by BMS when DEFSCRN has been sleeted as the screen size, 

j If the PGESIZE operand is omitted and the DEFSCRN operand is 

j specified, the page size defaults to the value of DEFSCRN. 

Note : BMS uses the page size values when preparing output data 

streams. The specified number of characters in each line of 
the page should not exceed the physical line width of the 
terminal. In the case of hard-copy devices that automatically 
perform a new-line function on reaching the end of the carriage 
| (for example, 3270 printers), the line width specified in the 

operand should be less than the physical line width. This will 
ensure that the formatting of the output data is governed 
entirely by the new-line (NL) characters supplied by BMS or by 
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the user, not by new-line functions performed by the device 
itself, which would produce additional lines of output, 
resulting in a physical page depth greater than that specified 
in this operand. 

lines 

indicates the number of lines in the page, 
columns 

indicates the number of characters in each line. 

If PGESIZE is not specified, the following defaults will be 


used: 


1050, 1403, 2740, 2741, 

2780, TW33, TW35, CRLP 

2770 Video, Printer, Cards 

(12,80) 

3653 

3650 User Program Terminal 

(6, 30) 
(3,80) 

3660 

(1,40) 

2980 Printer 

(12,40) 

3270 displays and printers 
- default to DEFSCRN value or, 
if this defaults, to TRMMODL=l or 
TRMMODL=2 

(12,40) 

(24,80) 

3270 displays C3650HC attached) 

(23,80) 

Console (CICS/DOS/VS only) 

(6,80) 

3767, 3770 Interactive logical 

(12,80) 


units, 

3770, 3790 Batch Data Interchange 
logical units, and 
3770, 3790 Full Function 
logical units. 

For a VTAM 3600, the PGESIZE specified is used if a BMS page 
build operation is attempted without specifying a logical 
device code (LDC). A default device type of 3604 is assumed. 

If no PGESIZE is coded, the default values of (1,40) are taken 
for 3600. 

For 3770 or 3790 batch data interchange logical units, the 
PGESIZE specified is used if a BMS page build operation is 
requested without specifying a logical device code (LDC). The 
default device type is the console printer. The default 
PGESIZE is (12,80). 

For 3270 printers, the hardware buffer size limits the amount 
of data which BMS may transmit. If the map or application 
program request specifies CTRL=L40, L64 or L80 or does not 
specify CTRL or PROPT, the product of lines and columns must 
not be greater than the buffer size. If the map or application 
program request specifies CTRL=HONEOM, the maximum number of 
characters to be transmitted by BMS must not exceed the 
terminal's buffer size. If the request specifies PROPT=NLEOM, 
the maximum number of characters to be transmitted by BMS must 
not be greater than the buffer size minus the number of lines 
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to be printed. In either of the last two cases, lines and 
columns may be specified such that the product is greater than 
the buffer size. If more data is transmitted than the buffer 
can hold, the data will be wrapped around in the buffer and 
data will be lost. 


1 PGESTAT=PAGE|AUTOPAGE 

specifies the type of paging activity that may occur at a given 

terminal. 

PAGE 

indicates that all requests to output data to the terminal 
from the page supervisor are to be paged unless specified 
| otherwise in the BMS requests. When paging, the first page 

from the paging supervisor is written to the terminal when 
the terminal becomes available. All subsequent pages in a 
page series are written to the terminal on request of the 
terminal operator through the use of paging commands. PAGE 
is the default for video terminals and for the processor 
console (CICS/DOS/VS only). 

AUTOPAGE 

indicates that all requests to output data to the terminal 
from the page supervisor are to be paged automatically 
| unless specified otherwise in the BMS requests. When 

autopaging, the page supervisor writes all pages in a page 
series to the terminal automatically. AUTOPAGE is the 
default parameter for the hard-copy terminals. Requests to 
write data directly to the terminal are not controlled by 
the PAGE or AUTOPAGE parameters because the page supervisor 
is not used for direct output. 


| PIPELN=LAST|POOL 

indicates that this is to be a 3600 or 3650 pipeline session. 
The default is PIPELN=LAST. 

LAST 

specifies that this is the last of a pool of 3600 or 3650 
pipeline sessions. This operand is only applicable when 
SESTYPE=PIPELINE. This operand must be coded for each 
SESTYPE—PIPELINE if each session is to be a pool of one 
pipeline session. 


POOL 

specifies that this 3600 or 3650 pipeline session is pooled 
with other pipeline sessions. This operand is only 
applicable when SESTYPE=PIPELINE and must be specified for 
each SESTYPE=PIPELINE (except the last in the pool) if the 
pipeline session is pooled. 
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POLLPOS=number 

specifies, as a decimal integer, the position (relative to 1) 
of the polling characters associated with this terminal in the 
DFTRMLST supplied for the line- If GENPOLL=YES is specified 
(or implied by default) for the line entry, P0LLP0S=1 is 
specified for each terminal entry associated with control unit 
1, P0LLP0S=2 is specified for each terminal entry associated 
with control unit 2, etc. 


PRINTTO=(label(,COPY]) 

J specifies the primary 3270 printer to be used to support DFHTC 

TYPE=PRINT or a print request via a Program Access key from the 
operator, if the subject of the DFHTCT TYPE=TERMINAL 
| instruction is a 3270 display without the printer-adapter 

feature, or a 3270 display attached to a 3274, 3276, or a 3790 
in 3270 compatibility mode without FEATURE=PTRADAPT- "label" 
is the symbolic name which must be specified as the label on 
the DFHTCT TYPE=TERMINAL macro identifying the printer. See 
also the ALTPRT operand earlier in the description of this 
macro. PRINTTO and ALTPRT are available for VTAM 3270s and 
3270 compatibility mode logical units only. 


| RELREQ=option 

indicates whether CICS/VS is to release the logical unit. The 
default is RELREQ=N0. 


(NO....) 

indicates that CICS/VS is not to release the logical unit 
upon request by another VTAM application program. 

(YES,...) 

indicates that CICS/VS is to release the logical unit, if 
the logical unit is not currently part of a transaction. 

(....NO) 

indicates that CICS/VS is not to honor a disconnect request 
for a VTAM device. NO is also the default. 

(....YES) 

indicates that CICS/VS is to honor a disconnect request for 
a VTAM device, and issue a VTAM CLSDST macro instruction to 
terminate the VTAM session with that logical unit. 

In addition, CSSF GOODNIGHT from the terminal will cause 
disconnection if YES is specified. 


| RUSIZE=size 

specifies the maximum size of a request unit (RU) which can 
satisfy a VTAM RECEIVE request sent to VTAM by CICS/VS. The 
default value is 256 bytes. 

| For LUTYPEs 2, 3, and 6 the value specified in RUSIZE will be 

| transmitted to the connected logical unit. This value may be 

1 adjusted slightly by CICS/VS according to the value specified, 

j because the value must be transmitted in an architected form, 

j Thus, the value may be rounded down by CICS/VS before being 

j transmitted. 
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SESTYPE=session-type 

Refer to the TRMTYPE operand earlier in this macro for details 
of the combinations of TRMTYPE/SESTYPE specifications which may 
be used to generate support for logical units in CICS/VS. 


STN2980=number 

specifies the number for which the alternate station address 
and normal station address are to be generated for each 
terminal entry in the terminal control table corresponding to a 
2980 General Banking Terminal System. In response to a given 
STN2980 specification, an appropriate (hexadecimal) alternate 
station address and normal station address are generated by 
CICS/VS as follows: 


Number 

Normal 

Alternate 

0 

40 

F4 

1 

FI 

F5 

2 

F2 

F6 

3 

F3 

F7 

4 

F8 

34 

5 

5C 

E4 

6 

61 

E5 

7 

E2 

E6 

8 

E3 

E7 

9 

E8 

24 


Example 1: For normal station address X"40 ', the user 
specifies STN2980=0 and an alternate station address of X*F4" 
is generated. 

Example 2: For a 2972 model 11 with normal station address 
X*F8'*, STN2980=4 should be specified, and an alternate station 
address of X"34" will be generated. 


TAB2980=value 

specifies, as a single-digit hexadecimal value (0 to F), the 
number of tabs to the passbook area as defined by the user and 
physically (uniquely) set on the terminal. The default is 
TAB2980=0. 


TASKNO=number 

specifies the number of concurrent tasks allowed to run in a 
pipeline session or in a pool of pipeline sessions and is only 
applicable when PIPELN=LAST is specified. 


TCTUAL=length 

specifies the length, in bytes (0 to 255), of the process 
control information field (PCI) for this terminal. The default 
is the TCTUAL value specified in the DFHTCT TYPE=LINE macro 
instruction, where applicable (that is, for BTAM and TCAM 
terminals only); if not specified there, the default is 
TCTUAL=0. The TCT user area length is initialized to zeros at 
system initialization. 


| TIOAL=value 

indicates the terminal input/output area length to be passed to 
| a transaction for non-SNA devices, or when CHNASSY=NO is 

j specified for logical units. 
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value 

If CHNASSY=NO, •value* specifies the minimum size of the 
terminal input/output area to be passed to a transaction by 
the terminal control program. If the size of an input 
message exceeds the value specified in this operand, the 
size of the TIOA corresponds to the size of the message. 

If CHNASSY=YES, * value* is the normal chain size and also 
the maximum chain size, so specifying the TIOA size. 

(value-1, value-2) 

If CHNASSY=NO is specified, * value-2* is ignored and 
"value-1* specifies as "value* above. If CHNASSY=YES, 
•value-1* is the normal chain size and *value-2* is the 
maximum chain size. If CHNASSY=YES, a TIOA of normal chain 
size will initially be acquired by DFHZCP to satisfy a 
DFHTC TYPE=READ request. If the normal chain size is not 
large enough, a TIOA of maximum chain size will be 
acquired. 

Note: The minimum size TIOA passed to a transaction which is 

running under control of 2260 compatibility is governed by the 
CMPT60L= operand in the generation of the terminal control 
program in the DFHSG PROGRAM=TCP macro instruction. For 
"FASTER" compatible terminals, the minimum TIOAL which may be 
specified is the 2260 screen size. If a smaller value is 
specified, TIOAL will default to the 2260 screen size. 

Note : If automatic transaction initiation is used, a non-zero 

TIOAL should be specified. 


TRANSID=name 

specifies a one- to four-character transaction code whose use 
is dependent upon the terminal type for which it has been 
specified. 

For the 3735 Programmable Buffered Terminal, the TRANSID 
operand is used to specify the transaction code of the 
transaction that is to be initiated for a batch transmission 
initiated by the terminal operator. If an inquiry message is 
received from the 3735, the transaction code used consists of 
the first one- to four-characters following the inquiry header 
(NULL I NULL). 

The TRANSID operand must be specified for the 3735 Programmable 
Buffered Terminal if batched input processing is required. 

The TRANSID operand is optional for the 3740 Data Entry System. 
When provided, it specifies the transaction code of the 
transaction to be attached when input is received in batch mode 
unless: 

1. Input is received from the operator ID card reader. In 
this case CSSN is attached to perform sign-on. 

2. The transaction is automatically initiated. In this case, 
the transaction code specified in the initiation request is 
attached. 
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3. The previous transaction specified TRANSID= in the DFHPC 
RETURN request. In this case, the requested transaction is 
attached. 

If the terminal is in inquiry mode, the transaction code is 
that specified in 1. or 2. (above) or is taken from the first 1 
to 4 bytes of data. 

Note ; If the 3740 does not have the expanded ID verification 
feature, the data must start in byte 1 of the second block. 
Refer to "ID Verification" under "3740 Programming 
Considerations" in Chapter 5.7 of this manual. 

When using TCAM, TRANSID applies only to TCTLEs associated with 
the TCAM output queue. 

If this operand is coded for a 3790 Communication System, and 
multiple sessions are used to connect the same 3791, the same 
transaction code should be specified for all sessions. 

The TRANSID operand must be specified for 3614 logical units. 

It is optional for 3601 logical units. 

For all other terminals, the TRANSID operand is used to specify 
the transaction code of a transaction that is to be initiated 
each time input is received from the terminal and there is no 
active task. 

If the TRANSID operand is omitted, the first one- to four- 
characters of the data passed in the TIOA are used as the 
transaction code. A delimiter is required for transaction 
identifications of less than four characters. If the TRANSID 
| specification has been made in a DFHPC RETURN request issued by 

the previous transaction, the transaction code is the one 
| supplied in the DFHPC request. In 3270 formatted mode, the 

transaction code follows the first set buffer address (SBA) 
sequence. 

Note : If TRANSID is specified for a terminal, the use of 

certain system transactions and functions on this terminal (for 
example CSMG and BMS page retrieval) can cause unpredictable 
| results, because they use the DFHPC RETURN request with the 

TRANSID operand. 


| TRMADDR=address|name 

specifies the terminal address. 

address 

specifies the device address associated with a given 
terminal and is only required for BTAM devices. For most 
non-switched lines, the hexadecimal addressing characters 
associated with the terminal must be specified. 


name 

specifies the label of the BTAM DFTRMLST macro instruction 
and is used for binary synchronous devices and switched 
lines. Use of the prefix ’TCT" in the label could cause 
assembly errors. 
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Notes 


1. TRMADDR is not required for some BTAM devices such as the 
2741, local 2260, and local 3270; it does not apply to 
VTAM-supported 3270s. See the terminal control table 
configurator at the beginning of the description of the 
terminal control table. 

2. For TWX, TRMADDR is not required if ANSWRBK=TERMINAL is 
specified in the DFHTCT TYPE=LINE macro instruction. 

3. For a 3735, the BTAM DFTRMLST must be of the SWLST.AD type. 

4. For Teletypewriters (WTC only), specifies the label of a 
list of DFHTCT TYPE=TLXID macro instructions. 


TRMMODL=number|character 

specifies the model number of the terminal associated with this 
communication line. If the device is one of the following, 
this operand must be included in either the DFHTCT TYPE=LINE or 
DFHTCT TYPE=TERMINAL specification: 

• Component of the 1050 Data Communication System 

• 2740 Communication Terminal Model 2 

• Component of the 2980 General Banking Terminal System 

• Component of the 3270 Information Display System 

• 2260 Display Station 

• 2265 Display Station 

Note : There is no DFHTCT TYPE=LINE macro for VTAM. 

number 
1 

specifies the 2980 Teller Station Model 1, and 3270 
(Model 1) displays and printers with a default screen 
or buffer size of 40 characters (for example, 3277 
Model 1). TRMMODL=l is the default for 3270 (Model 1) 
printers and displays. 

2 

specifies the 2740 Communication Terminal Model 2, 2980 
Administrative Station Model 2, and 3270 displays and 
printers with a default screen or buffer size of 80 
characters (for example, 3278 Model 4). TRMMODL=2 is 
the default for the 3286 printer in 3270 compatibility 
mode. 

4 

specifies the 2980 Teller Station Model 4. 

5 

specifies component polling of the keyboard for the 
1050 Data Communication System using nonswitched 
communication lines. Component selection character 5 
(0B) must be coded in the polling list (DFTRMLST). 
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6 


specifies component polling of reader 1 for the 1050 
Data Communication System using non-switched 
communication lines, component selection character 6 
(0D) must be coded in the polling list (DFTRMLST). 


7 

specifies the component polling of reader 2 for the 
1050 Data Communication System using nonswitched 
communication lines. Component selection character 7 
(0E) must be coded in the polling list (DFTRMLST). 

11 

specifies the 3275 Display Station Model 11. The 
CICS/VS support obtained will be identical to that for 
specifying TRMMODL=l for 3275 Display Station Model 1. 

12 

specifies the 3275 Display Station Model 12. The 
CICS/VS support obtained will be identical to that for 
specifying TRMMODL=2 for 3275 Display Station Model 2. 

0 

specifies an input component for the 1050 Data 
Communication System. Common polling character 0 (15) 
must be coded in the polling list (DFTRMLST). 

TRMMODL=0 is the default specification for a 1050 Data 
Communication System. 

character 

specifies the applicable screen format for a 2260/2265 
display station as follows: 


Soecification 

Screen 

Format 

TRMMODL=A 

6X40 

2260 

TRMMODL=B 

12X40 

2260 

TRMMODL=C 

12X80 

2260 

TRMMODL-D 

15X64 

2265 

TRMMODL=E 

12X80 

2265 


For example, TRMMODL=A specifies a 2260 Display Station 
with a 6X40 screen format. 


TRMPRTY=number 

establishes the terminal priority. This decimal value (0 
through 255) is used in establishing the overall transaction 
processing priority. (Transaction processing priority is equal 
to the sum of the terminal priority, transaction priority, and 
operator priority, not to exceed 255.) The default is 
TRMPRTY=0. 


TRMSTAT=terminal-status 

specifies the type of activity which may occur at a given 
terminal. This terminal status is initially set in the TCTTE 
and is a combination of the processing status and the service 
status. 

TRANSACTION 

indicates that a terminal with TRANSACTION status is used 
in the processing of transactions such as inquiries or 
order entries.. A display station or a hard-copy terminal 
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to which no messages are sent without a terminal request 
and through which transactions are entered is a TRANSACTION 
terminal. If no other status designation is made, the 
terminal status defaults to TRANSACTION. 

Note : This is the only processing status allowed for 3790 
inquiry logical units. 

TRANSCEIVE 

indicates that a terminal with TRANSCEIVE status is a 
TRANSACTION terminal to which messages are sent 
automatically by the user. The automatic transaction 
initiation, either by transient data control or interval 
control, sets a condition in an appropriate terminal 
control table terminal entry. If the terminal status is 
TRANSCEIVE and if there is no transaction at the terminal, 
terminal control initiates the user-defined task. This 
task is expected to send messages to the terminal. 

Note : If automatic transaction initiation is used, a non¬ 

zero TIOAL value should be specified. 

RECEIVE 

indicates a terminal to which messages are sent but from 
which no input is allowed. An example of this type of 
terminal is one which is located in a remote location, such 
as a warehouse, and is unattended, but may receive 
messages. Automatic transaction initiation is implemented 
as for TRANSCEIVE above. 

Note : RECEIVE should be specified for a System/7 with the 

Station Control feature. This allows polling to be 
suspended until the System/7 receives an IPL from the host, 
at which time the status is changed to TRANSCEIVE. If the 
System/7 receives a remote IPL, the master terminal must be 
used to change the terminal status to enable the System/7 
to transmit. 


IPL 

specifies that this is the logical terminal entry required 
for the IPL address of the System/7 with BSCA. To IPL a 
System/7 on a Bisync line, a TCTTE must be generated 
exclusively for the IPL operation. This operand causes the 
logical terminal to be generated in RECEIVE status and sets 
the terminal model number to "9" to signify an IPL 
terminal. The status of an IPL terminal may not be changed 
except to in-service or out-of-service. 


INPUT 

indicates a terminal which can send messages to, but cannot 
receive messages from, CICS/VS. 

Notes : 

1. INPUT status is not valid for the 3270 and the 3790 inquiry 
logical unit. 

2. System messages may be routed to an input terminal under 
conditions such as invalid transaction identification and 
ATP batch count. This causes DFHTACP to be scheduled. To 
handle this situation, the user should code a DFHTEP to 
perform any user required action. See "User-Written 
Terminal Error Programs" in Chapter 4.2 of this manual. 
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•out of service* 

indicates a terminal which can neither receive messages nor 
transmit input. Such terminals are not polled by CICS/VS. 
The '* OUT OF SERVICE* parameter can be used in combination 
With TRANSACTION, TRANSCEIVE, or RECEIVE. 

All terminals except the master terminal can be designated 
as *OUT OF SERVICE*. When appropriate, the terminals can be 
placed in service by the master terminal and polling will 
be resumed. 


VF=NO|YES 
HF=NOlYES 

indicate whether the Vertical Form and Horizontal Form features 
are to be supported by the terminal. VF=NO or HF=NO will 
override Vertical or Horizontal definitions referenced in the 
parameters VTAB=(tab,...) and HTAB=(tab,...) of the DFHMSD 
macro instruction. These operands may be used with TCAM. 


TELETYPEWRITER (WTC ONLY) STATION IDENTIFICATION — DFHTCT 
TYPE=TLXID 


The DFHTCT TYPE=TLXID macro instruction is used to define Teletypewriter 
(WTC only) station identifications. 


r- r - r -- 

j name jDFHTCT j TYPE=TLXID 
| j j , TLXID= * name'* 

| j I C,LASTID={NO|YESH 

t-L-L—- 


1 

I 

I 

I 

J 


name 

the name field of the macro instruction is required and must be 
the same as the symbolic address specified in the TRMADDR 
parameter of the DFHTCT TYPE=TERMINAL macro instruction. 


TYPE=TLXID 

specifies one entry for the identification of Teletypewriters 
(WTC only). 


TLXID=*name' B 

specifies the identification of a Teletypewriter (WTC only) 
subscriber as stored on a mechanical drum within the terminal. 
A more detailed explanation is given in OS/VS Basic 
Telecommunications Access Method and DOS/VS Basic 
Telecommunications Access Method . An identification is a 
string of up to 20 characters. The first three characters are 
letter shift (LTRS), carriage return (CR) and line feed (LF) ; 
they are not part of the name operand. Only the first 12 
characters are used to form the name, which is a string of 
alphanumeric characters. Shift characters must not be used in 
the operand field. 


LASTID= 

indicates the "last ID" condition? the default is LASTID=NO. 
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TELETYPEWRITER (WTC ONLY) DISCONNECT MESSAGE — DFHTCT 
TYPE=TLXMSG 


CICS/OS/VS does not support program disconnect for World Trade Teletype 
terminals. If a DFHTC TYPE=DISCONNECT request is issued, a message is 
written to the terminal, indicating that the terminal operator should 
manually disconnect. The message that is written can be specified in a 
DFHTCT TYPE—TLXMSG macro. 


r r r - - 

1 name |DFHTCT | TYPE=TLXMSG 
j | j , MESSAGE^ "message'* 

L-- L--L—- 


I 

I 


J 


name 

is required and must be the same as the name specified in the 
DISMSG parameter of the DFHTCT TYPE=TERMINAL macro instruction. 


TYPE=TLXID 

indicates that a DISCONNECT message is being defined. 


TLXMSG=’* me ssage * 

defines the message to be written in response to a DFHTC 
TYPE=DISCONNECT request. 


DIGITAL RESPONSE MESSAGES FOR 7770 AUDIO RESPONSE UNIT — 
DFHTCT TYPE=7 7 7 OMSG 


For CICS/VS to communicate with an audio terminal (for example, the 2721 
Portable Audio Terminal), two digital response messages (an error 
message and a ready message) must be defined in the terminal control 
table for each line. This is accomplished by issuing the DFHTCT 
TYPE=777 OMSG macro instruction, which must immediately precede the 
DFHTCT TYPE=FINAL macro instruction. To avoid confusion, these messages 
should be unique; that is, these messages should not also be defined in 
user-written application programs. 


The ready message is used by CICS/VS: 

• In response to a valid terminal identification being entered 
subsequent to line connection. 

• When the sign on sequence has been completed. 

• When a 7770 Audio Response Unit is connected to a line and no 
transaction is associated with the 7770. 

• In response to a READ request if the request sequence was not a 
WRITE, READ. 

The error message is used by CICS/VS: 

• In response to an invalid terminal identification being entered 
subsequent to line connection. 
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• When a valid terminal identification has been entered but: (1) the 
terminal has an "out of service" status, or (2) the terminal has an 
"in service" status but the terminal identification has already 
been entered on another line. 

• In response to an invalid transaction identification. 

• In response to an error during the signon/signoff sequence. 

• If the input message is too long. 

• If the transaction associated with the 7770 is abnormally 
terminated. 

• If a 32-second timeout occurs. 


r - r - r -----1 

| name j DFHTCT | TYPE=7770MSG, j 

j j j MESSAGE^'message" j 


name 

is required and must be the same as the symbolic address 
specified in the RDYMSG or ERRMSG parameters of the DFHTCT 
TYPE=LINE macro instruction. 


TYPE=777 OMSG 

indicates audio response messages. 


| MESSAGE-'message* 

defines digital response messages for the 7770 Audio Response 
Unit. These messages must be constructed in the form of 
hexadecimal constants, enclosed within single quotes, and may 
contain up to 48 hexadecimal digits (24 bytes). The first two 
digits must contain binary zeros (00) to represent a one-byte 
"silence" track address on the 7770; subsequent digits may be 
used to represent up to 23 additional one-byte 7770 track 
| addresses. For further details, see Component Description 7770 

Audio Response Unit Model 3 . 

See Appendix B for an example of a typical digital response 
specification. 


END OF TERMINAL CONTROL TABLE — DFHTCT TYPE=FINAL 


The end of the terminal control table is indicated to the control system 
by the DFHTCT TYPE=FINAL macro instruction, which must be contained on 
the last control card for the terminal control table assembly before the 
assembler END statement. 

r-r- r~ ------—--- ~i 

| |DFHTCT | TYPE=FINAL | 

L-L-L-----.---J 


TYPE=FINAL 

indicates the end of the terminal control table. 
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EXAMPLE 


| Figure 3,2-15 illustrates the coding which is required to create a 
CICS/VS terminal control table. The terminal network described 
includes: 

• One DASD sequential terminal 

• Two 2740 Telecommunication terminals with the Station Control 
feature 

• Two 1050 Data Communication terminals (dial-up) 

Note : DFTRMLST macro definitions are required by BTAM devices. These 
entries should be coded immediately preceding the DFHTCT TYPE=LINE 
entries or immediately following DFHTCT TYPE=TERMINAL entries. 

To be applicable to CICS/OS/VS, or if converting from CICS/DOS/VS to 
CICS/OS/VS, the following changes must be made: 

• The DDNAME operand must be included unless the name specified in 
the DSCNAME operand is an acceptable default. 

• When used, the MODELST operand must be recoded as the MODE operand. 

• The MACRF operand must be included unless the default value for 
this operand is acceptable. 

If converting from CICS/DOS/VS to CICS/OS/VS, operands applicable 
only to CICS/DOS/VS need not be removed, because they are ignored by 
CICS/OS/VS. 

For other examples of terminal control table preparation, see 
Appendix B. 
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DFHTCT 

TYPE=INITIAL 

START OF TCT 


DFHTCT 

TYPE=SDSCI, 

SPECIFY DATA SET CONTROL 

* 


DEVADDR=SYS001, 

INFORMATION 

* 


DEVICE=2314, 

DSCNAME=DISKINl 


* 

DFHTCT 

TYPE=SDSCI, 

SPECIFY DATA SET CONTROL 

* 


DEVADDR=SYS006, 

INFORMATION 

* 


DEVICE=2314, 

DSCNAME=DISKOTl 


* 

DFHTCT 

TYPE=LINE, 

DASD LINE ENTRY 

* 


ACCMETH=SEQUENTIAL, 


* 


TRMTYPE=DASD, 


* 


ISADSCN=DISKINl, 


* 


OSADSCN=DISKOTl, 

INAREAL=80 


* 

DFHTCT 

TYPE=TERMINAL, 

DASD TERMINAL ENTRY 

* 


TRMIDNT=S AMB, 

DASD SYMBOLIC NAME 

* 


TRMPRTY=11, 
TRMSTAT=TRANSCEIVE 


* 

DFHTCT 

TYPE=SDSCI, 

SPECIFY DATA SET CONTROL 

* 


CU=2703 f 

INFORMATION 

* 


DEVICE=2740, 


* 


FEATURE=(STC,CHK), 


* 


LINELST=(027), 


* 


SWITCH=NO, 

DSCNAME=DTF40MD 


* 

PL2740L1 DFTRMLST OPENLST,(46,45) 

POLL LIST TERMINAL 


DFHTCT 

TYPE=LINE, 

2740 LINE ENTRY 

* 


ACCMETH= BTAM, 


♦ 


TRMTYPE=2 740, 


* 


TRMMODL=l, 


♦ 


DSCNAME=DTF40MD, 


* 


BTAMRLN=1 , 


* 


LISTADR=PL2740L1, 

POLL LIST NAME 

* 


INAREAL=240, 


* 


FEATURE=(SCONTROL,CHECKING) 


DFHTCT 

TYPE=TERMINAL, 

2740 TERMINAL ENTRY 

* 


TRMIDNT=T41L, 

2740 SYMBOLIC NAME 

* 


TRMADDR=46, 

TERMINAL ADDRESS = L 

* 


TRMPRTY=127, 
TRMSTAT=TRANSCEIVE 


* 

DFHTCT 

TYPE=TERMINAL , 

2740 TERMINAL ENTRY 

* 


TRMIDNT=T41K, 

2740 SYMBOLIC NAME 

♦ 


TRMADDR=4 5, 

TERMINAL ADDRESS = K 

* 


TRMPRTY=128, 


* 


TRMSTAT=TRANSCEIVE, 
LASTTRM=LINE 

LAST TERMINAL ON LINE 

* 

DFHTCT 

TYPE=SDSCI, 

SPECIFY DATA SET CONTROL 

* 


CU=2703, 

INFORMATION 

* 


DEVICE=1050, 


* 


LINELST=(0 31), 


* 


SWITCH=YES, 


* 


DSCNAME=DTF1050 

| Figure 3.2-15 (Part 1 of 2),. Terminal Control Table - Example 
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IDL1050 DFTRMLST DIALST,0,(6215,6«15> 

DIL1050A DFTRMLST DIALST,7,1239876,(6213) 

DIL1050B DFTRMLST DIALST,7,1239875,(6413) 

DFHTCT TYPE=LINE, 1050 LINE ENTRY * 

ACCMETH=BTAM, * 

TRMTYPE=1050, * 

DSCNAME=DTF1050, * 

INAREAL=80, * 

BTAMRLN=1, * 

LISTADR=IDL1050, POLL LIST NAME * 

FEATURE=(AUTOANSR,AUTOCALL), * 

POOLADR=T5 0 POOL, * 

ANSWRBK=TERMINAL 

T50POOL DFHTCT TYPE=TERMINAL, 1050 TERMINAL ENTRY * 

TRMIDNT=T50A, * 

TRMADDR=DIL10 50A, * 

TRMPRTY=2 03, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, 1050 TERMINAL ENTRY * 

TRMIDNT=T5 0B, * 

TRMADDR=DIL1050B, * 

TRMPRTY=20«, * 

TRMSTAT=TRANSCEIVE, * 


LASTTRM=POOL LAST TERMINAL ON LINE 

DFHTCT TYPE=FINAL END OF TCT 

| END 

| Figure 3.2-15 (Part 2 of 2). Terminal Control Table - Example 


TLT — TERMINAL LIST TABLE 


A terminal list table (TLT) generated by the DFHTLT macro instruction 
allows terminal and/or operator identifications to be grouped logically. 
A terminal list table: 

TRAN TLT SUFFIX 
ID SPECIFIED BY XX 

• Is required for use of a supervisory CSST ...SUPRID=xx 

terminal operation to define and 

limit the effective range of the 
operation. 

• May be used by a supervisory or CSST ...CLASID=xx 

master terminal operation to apply CSMT ...CLASID=xx 

a function to a predetermined group 

of terminals. (For a CSST function, 
this TLT must define a subset of 
the TLT specified by the SUPRID 
keyword.) 

• May be used singly or in combination CMSG .».ROUTE=.xx 

with other TLTs to provide predefined 

destinations for message switching.. 

The module name of the terminal list table is DFHTLTxx where xx is a 
one- or two-character suffix to provide unique identification for each 
terminal list table used. There must be an entry in the processing 
program table (PPT) for each terminal list table to be used. 

The same TLT can be used for message switching and for supervisory or 
master terminal functions. For example, a TLT which defines the 
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terminals which are under control of a supervisory terminal, could also 
be used as a destination list for sending messages to those terminals. 

For some logical units, logical device code (LDC) mnemonics, which 
may be associated with each table entry, are used for message switching 
and are ignored for master and supervisory terminal operations. 


CONTROL SECTION — DFHTLT TYPE=INITIAL 


The entry point and the address of the start of the terminal list table 
being defined are established by the DFHTLT TYPE=INITIAL macro 
instruction. 


r - r - r - 

I jDFHTLT | TYPE=INITIAL 

j | | [,LDC=aa] 

| | | C,SUFFIX=xxl 

L-t-L- 


1 

I 

I 

I 

J 


TYPE=INITIAL 

establishes the control section into which the terminal list 
table is assembled. 


LDC=aa 

specifies a two-character logical device code (LDC) mnemonic 
that is associated with every logical unit identification 
except for those for which an LDC mnemonic has been specified 
by *ldc. (See explanation of *ldc in the TRMIDNT operand of 
the DFHTLT TYPE=ENTRY macro instruction.3 


SUFFIX=xx 

specifies a one- or two-character suffix for the terminal list 
table being assembled. This suffix, if specified, is appended 
to the standard module name (DFHTLT) and is used to name the 
module on the linkage editor output library. If this operand 
is omitted, a suffix is not provided. 

Note : A TLT must have a suffix to be used by message switching 
(CMSG). 


ENTRIES IN THE TERMINAL LIST TABLE — DFHTLT TYPE=ENTRY 


Entries are specified in the terminal list table as follows: 


| | DFHTLT | TYPE=ENTRY | 
j | | ,TRMIDNT=(Ctermid-1C*ldc-1]3 C/opid-1] j 
| | | [,termid-2t*ldc-2)[/opid-2],.-.)] | 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 
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| TRMIDNT=terminal-identification 

specifies a list of start-stop and BSC terminal, and/or logical 
unit identifications, and/or operator identifications. A 
logical unit identification can be qualified by an LDC 
mnemonic. 

termid 

indicates a one- to four-character start-stop or BSC 
terminal or logical unit identification. 

Note ; A 3614 attached to a communications controller may 
be used in master or supervisory terminal operations but 
should not be used in message switching operations. (A 
3614 is not valid for a message destination.) 


Idc 

indicates a two-character LDC mnemonic, which must be 
preceded by an asterisk (*) and a logical unit 
identification (termid). 


opid 

indicates a one- to three-character operator identification 
which must be preceded by a slash (/). 


Notes : 

1. Any terminal or operator identification specified should also be 
specified in the TRMIDNT operand of the DFHTCT macro instruction or 
the OPIDENT operand of the DFHSNT macro instruction respectively, 
except for outboard operator identifiers for the batch logical 
unit, which need not be defined to DFHSNT (see the BMSFEAT=0B0PID 
operand in DFHTCT TYPE=TERMINAL). Any LDC mnemonic specified 
should also be specified in the LDC operand of the DFHTCT TYPE=LDC 
and DFHTCT TYPE=TERMINAL macro instructions. 

2. Supervisory and master terminal functions use all terminal and 
logical unit identifications included in the TLT, but ignore all 
references to LDC mnemonics and operator identifications. 


END OF TERMINAL LIST TABLE — DFHTLT TYPE=FINAL 


The macro instruction used to specify the end of a terminal list table 
is: 


r 

I 


L. 


DFHTLT | TYPE=FINAL 




.J 


TYPE=FINAL 

indicates the end of the terminal list table. The assembler 
END statement must follow. 


EXAMPLE 


| Figure 3.2-16 illustrates coding to create a terminal list table. 
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DFHTLT TYPE=INITIAL, * 

SUFFIX=AA 

DFHTLT TYPE=ENTRY, * 

TRMIDNT=(NYC , CHI, LA,WDC) 

DFHTLT TYPE=ENTRY, * 

TRMIDNT=SF 

DFHTLT TYPE=ENTRY, * 

TRMIDNT=C BSTN/0P1,ATL/OP5,/OP9,DNVR) 

DFHTLT TYPE 25 ENTRY, * 

TRMIDNT=/OP6 
DFHTLT TYPE=FINAL 
| END 


| Figure 3.2-16 (Part 1 of 2). Terminal List Table - Example 1 


DFHTLT TYPE=INITIAL, 

SUFFIX=BB 
DFHTLT TYPE=ENTRY, 

TRMIDNT=(NYC,T361*LP,T362+LP/0P1) 
DFHTLT TYPE=ENTRY, 

TRMIDNT=(T36 3/OP2,T3 6 4/OP5,T 36 5) 
DFHTLT TYPE=FINAL 

| END 


| Figure 3.2-16 (Part 2 of 2). Terminal List Table - Example 2 


* 

♦ 

♦ 


TST — TEMPORARY STORAGE TABLE 


The temporary storage table is a list of generic mnemonics used to 
identify temporary storage DATAIDs, which may be specified in either of 
two ways: 

• DFHTST TYPE=RECOVERY|ENTRY — each entry in the table specifies the 
leading characters of user-defined DATAIDs for which CICS/VS will 
provide protection during a logical unit of work by an application 
program, and automatic logging of the status of the data at task 
termination (or sync point). 

• DFHTST TYPE=REMOTE —access is provided to remote temporary 
storage queues in an intersystem communication session. 

When a task accesses temporary storage data designated as 
recoverable, the data is protected from access by a concurrent task by 
enqueueing on the data identification (DATAID). The DATAID is not 
dequeued until the task terminates or issues a task sync point request 
to designate the end of a logical unit of work. At this time a log 
record is written to the system log data set to provide external 
information sufficient to recover the data in the event that the system 
or transaction subsequently terminates abnormally. 


CONTROL SECTION — DFHTST TYPE=INITIAL 


The entry point and the beginning address for the temporary storage 
table being defined are established by the DFHTST TYPE=INITIAL macro 
instruction. 
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TYPE=INITIAL 
C,SUFFIX=xx3 
[,TSAGE=n3 


- 1 


J 


TYPE=INITIAL 

establishes the control section into which the temporary 
storage table is assembled. 


SUFFIX=xx 

specifies a one- or two-character alphameric suffix (other than 
•NO* which is reserved) for the temporary storage table being 
assembled. This suffix, if specified, is appended to the 
standard module name (DFHTST) and is used to name the module on 
the linkage editor output library. If this operand is omitted, 
a suffix is not provided. 


| TSAGE=number 

defines the ageing limit of temporary storage data used by the 
temporary storage recovery program (DFHTSRP) during emergency 
restart of CICS/VS. Data which is older than the specified 
limit will not be recovered. The value is specified in days 
with a maximum value of 512. A value of zero indicates that no 
data is to be purged on this basis. The default is zero. 


| TEMPORARY STORAGE DATAIDS — DFHTST TYPE=RECOVERY|ENTRY 


The generic mnemonics used to define temporary storage DATAIDs for which 
recovery processing is to be performed are specified by the DFHTST 
| TYPE=RECOVERY|ENTRY macro instruction. 

r r r - -------1 

| j |DFHTST | TYPE=RECOVERY|ENTRY j 

|j | t,DATAID=(character-string,character-string,...)3 j 

l -t-L--J 


| TYPE=RECOVERYjENTRY 

specifies that one or more entries are to be generated in this 
| table. It identifies the temporary storage queue names that 

| are recoverable. If, in an intersystem communication session, 

| a temporary storage queue name is such that it could be remote 

| and recoverable, it is considered to be remote. Recoverability 

j can only be specified in the system in which the queue is 

j local. 


DATAID=character string 

is used to specify a one- to eight-character alphameric 
mnemonic representing the leading characters of temporary 
storage DATAIDs for which recovery processing is to be 
performed. The parentheses are not required if only one 
character string is specified. 

Note: If a temporary storage table is generated with no entries, no 

recovery processing will be performed, even though the temporary storage 
program is generated with the recovery option. If an interval control 
PUT request is issued without the REQID parameter, CICS/VS will generate 
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request identifications starting with the prefix "DF". If recovery is 
required for these requests, the temporary storage table should be 
| generated with the corresponding generic mnemonic. All DATAID prefixes 
| used in restartable transactions (those with RESTART=YES in DFHPCT 
j TYPE=ENTRY) should be made recoverable (including the default "DF" 

| prefix). 

Recoverability only applies to data put to auxiliary storage. Data 
put to main storage is not recoverable, regardless of the DATAID 
| specified or the options generated in the temporary storage program. 


| REMOTE TEMPORARY STORAGE QUEUES — DFHTST TYPE=REMOTE 

I 

| The DFHTST TYPE=REMOTE macro instruction generates temporary storage 
j queue names, which relate to remote systems participating in an 
| intersystem communication session. 


| r T| 
| | |DFHTST | TYPE=REMOTE { 

|| | | ,DATAID=character-string j 

|j | j ,SYSIDNT=name j 

|| j j (,RMTNAME=character-string] | 

j l -:-i 


I TYPE=REMOTE 

j indicates that this temporary storage table entry defines a set 

| of remote temporary storage queues. 


| DATAID^character-string 

j indicates a one- to eight-character alphanumeric mnemonic that 

j represents the leading characters of the DATAID of a temporary 

| storage queue that will reside on a remote system (identified 

j by the name in the SYSIDNT operand). The DATAID name is used 

| by application programs in the system that is local to this 

j TST. 


| SYSIDNT=name 

| identifies the system in which the remote temporary storage 
| queue resides. The name specified must be the same as that 
j specified in SYSIDNT in the terminal control table. 


I RMTNAME=character-string 

I specifies the prefix that will replace that specified in the 

I DATAID operand when a reference to the temporary storage queue 

I is transmitted to a remote system. This operand will default 

I to the character string specified in the DATAID operand. The 

! length of the character string specified in this operand must 

I be the same as that in the DATAID operand. 
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| END OF TEMPORARY STORAGE TABLE — DFHTST TYPE=FINAL 


The end of the temporary storage table is indicated to the control 
system by the DFHTST TYPE=FINAL macro instruction which is the last 
statement in the assembly of the temporary storage table before the 
assembler END statement. This macro instruction creates a dummy entry 
to signal the table end. 


| DFHTST | TYPE=FINAL 


TYPE=FINAL 

indicates the end of the temporary storage table. 


EXAMPLE 


Figure 3.2-17 illustrates an example of 
CICS/VS temporary storage table. 

DFHTST TYPE=INITIAL, 

SUFFIX^RC 

* 

DFHTST TYPE=RECOVERY, 

DATAID=Y 

♦ 

DFHTST TYPE=RECOVERY, 

DATAID=(EY,ERY) 

* 

DFHTST TYPE=RECOVERY, 

DATAID=RECOVERY 
DFHTST TYPE=REMOTE, 

♦ 

DFHTST TYPE=REMOTE, 

DATAID=YR 


DFHTST TYPE=FINAL 
END 


the coding necessary to create a 


LIST OF DATAID 

MNEMONICS TO BE 

RECOVERABLE 

DATAIDS BEGINNING 

WITH * Y* ARE 

RECOVERABLE 

DATAIDS BEGINNING 

WITH 'EY* OR "ERY* ARE 

RECOVERABLE 

DATAID '* RECOVERY'* 

IS RECOVERABLE 
DATAIDS BEGINNING WITH 
"R* ARE RECOVERABLE 
REMOTE DATAID 
NOT RECOVERABLE (ALTHOUGH 
BEGINS WITH *Y f ) UNLESS 
SPECIFIED AS RECOVERABLE 
IN THE REMOTE SYSTEM 


Figure 3.2-17. Temporary Storage Table - Example 


XLT — TRANSACTION LIST TABLE 


The transaction list table, generated by the DFHXLT macro instruction, 
is a list of a logically related group of transaction identifications. 
One use of an XLT is to define a list of transaction identifications 
which can be initiated from terminals during the first quiesce stage of 
system termination. The suffix of the table to be used is specified at 
system initialization and can be changed during system termination. 
Another use is to define a logically related group of transaction 
identifications to be disabled or enabled through the master terminal. 
The suffix of the table to be used in this case is provided through the 
master terminal at execution time. 
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Each transaction list table must have an entry in the processing 
program table (PPT). 

Figure 3.2-18 illustrates the coding to create a transaction list 
table. 


CONTROL SECTION — DFHXLT TYPE=INITIAL 


The entry point and start address of the transaction list table being 
defined are established by the DFHXLT TYPE=INITIAL macro instruction. 

\ [dFHXLT [ TYPE=INITIAL ] 

| | j [,SUFFIX=xx] I 


TYPE=INITIAL 

establishes the control section into which the transaction list 
table is assembled. 


SUFFIX=xx 

is a one- or two-character alphameric suffix for the 
transaction list table being assembled. This suffix if present 
is appended to the standard module name (DFHXLT) which is used 
to name the module on the linkage editor output library. 


ENTRIES IN TRANSACTION LIST TABLE — DFHXLT TYPE=ENTRY 


Entries are specified in the transaction list table as follows: 


r - r -- r --- 

j jDFHXLT j TYPE=ENTRY 

j | I ,TASKREQ=(kkk[,kkk],...) 

|| | j ,TRANSID=(xxxxC,xxxx],-) 

L-L-L- 


'1 


I 

I 

I 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 


TASKREQ=kk 

represents one of the following 3270 special keys which can be 
used to initiate a task: PAl through PA3, and PFl through 
| PF24. LPA (light pen attention) indicates that a transaction 

is to be initiated when a light pen detectable field is 
| selected. OPID (operator identification card reader) indicates 

| that a transaction will be initiated when the appropriate 

j operator # s identity badge has been read in. An entry in the 

PCT is required for each TASKREQ generated. 


TRANSID=xxxx 

represents a one- to four-character transaction code. An entry 
in the PCT is required for each TRANSID. 


Chapter 3.2. DFHXLT TYPE=ENTRY 


309 







Note : TASKREQ and TRANSID are mutually exclusive parameters. 


END OF TRANSACTION LIST TABLE — DFHXLT TYPE=FINAL 


The macro instruction used to specify the end of the transaction list 
table is? 

\ [dFHXLT | TYPE=FINAL ] 

TYPE-FINAL 

indicates the end of the transaction list table. The assembler 
END statement must follow. 


EXAMPLE 


DFHXLT TYPE=INITIAL, 

SUFFIX=IN 

♦ 

♦ 

DFHXLT TYPE=ENTRY,TASKREQ=PF5 

* 

* 

♦ 

DFHXLT TYPE=ENTRY,TRANSID=(CSMT,CSSF) 
DFHXLT TYPE=FINAL 
END DFHXLTBA 


LIST OF TRANSACTIONS WHICH 
WILL BE ACCEPTED DURING THE 
FIRST QUIESCE PHASE OF 
SYSTEM TERMINATION 
(TASKREQ MUST ALSO BE 
ENTERED IN THE PCT AND AN 
ENTRY FOR THE XLT MUST 
ALSO BE MADE IN THE PPT) 


i 


DFHXLT TYPE=INITIAL, 

SUFFIX=Gl 

DFHXLT TYPE=ENTRY f TRANSID=(TSSA,TSRA) 
DFHXLT TYPE=ENTRY,TRANSID=(TDSA,TDRA) 
DFHXLT TYPE=ENTRY,TRANSID=ICSA 
DFHXLT TYPE=FINAL 
END 


LIST OF LOGICALLY RELATED 
TRANSIDS TO BE ENABLED OR 
DISABLED BY MASTER TERMINAL 
(TRANSIDS MUST ALSO BE 
ENTERED IN THE PCT) 


| Figure 3.2-18. Transaction List Table - Example 


310 


CICS/VS System Programmer's Reference Manual 





(Chapter 3.3. Table Preparation for Recovery/Restart 

Support 


The generation of recovery/restart support in CICS/VS is discussed below 
under the following headings: 

• Telecommunication errors 

• Program checks in application programs 

• Operating system abends 

• CICS/VS warm restart 

• CICS/VS dynamic transaction backout and transaction restart 

• CICS/VS emergency restart 

The CICS/VS System/Application Design Guide discusses the various 
functions of recovery/restart in detail- Chapter 2.3 of this manual 
describes the actions necessary in the system generation process to take 
advantage of these facilities. The specifications which need to be made 
during the preparation of CICS/VS system tables are described below. 


TELECOMMUNICATIONS ERRORS 


The program control table (PCT) must contain an entry for the VTAM 
logical unit node abnormal condition transaction (CSNE) if the 
installation has terminals connected to CICS/VS via VTAM, and/or the 
terminal abnormal condition program transaction (CSTE) if the 
installation has non-VTAM terminals. Refer to Appendix A for details of 
these transactions. 


The processing program table (PPT) must contain entries for the 
following programs if the access methods indicated are used in the 
| system. The appropriate DFHPPT TYPE=GROUP,FN=function macros may be 
| used to provide these entries: 












DFHTACP 

DFHTEP 

DFHTEPT 

DFHZNAC 

DFHZNEP 


Terminal abnormal condition program (BTAM) 

Terminal error program (BTAM) 

Terminal error program table (only required if the CICS/VS 
sample terminal error program is used) (BTAM) 

Node abnormal condition program (VTAM) 

Node error program (VTAM) 


If re-presentation of in-doubt committed output messages is required 
after the recovery of a failed VTAM session, terminal recovery support 
should be specified as under "CICS/VS Emergency Restart" below. 
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PROGRAM CHECKS IN APPLICATION PROGRAMS 


No table generation actions are required in this situation. If the 
installation wishes to have a program error program (DFHPEP) invoked in 
the event of a transaction abend, an entry for DFHPEP should be made in 
the PPT. 


OPERATING SYSTEM ABENDS 


A system recovery table (SRT) must be generated to indicate which 
specific operating system abends are to be handled. 


CICS/VS WARM RESTART 


When generating the system initialization table (DFHSIT) the following 
specifications can be made: 

• The abnormal keypoint operand (ABKPOPT) may be specified. This 
operand would normally be specified as NO, because as a general 
rule a warm restart may not be possible after abnormal termination. 

• Each of the warm restartable resources must be specified as such. 

• The KPP operand must indicate the suffix to be used for the 
keypoint program. 


| CICS/VS DYNAMIC TRANSACTION BACKOUT AND TRANSACTION RESTART 


The following provisions should be made when generating dynamic 
transaction backout support: 

| • The DBP and DBUFSZ must be specified in the system initialization 

table (DFHSIT). 

• An entry for the appropriate dynamic transaction backout program 
| (DFHDBPxx) must be made in the processing program table either 

j through DFHPPT TYPE=ENTRY,PROGRAM=DFHDBP or through the DFHPPT 

j TYPE=GROUP,FN=BACKOUT macro. The suffix on this entry must 

j correspond with the suffix specified in the DBP=xx operand in 

| DFHSIT. 

| • DTB=YES (or DTB=(YES,NO) for an intersystem communication session) 

j should be specified in the program control table (DFHPCT) for each 

transaction code for which dynamic transaction backout is to be 
j performed, and for the "mirror" transaction (CSMI) for recoverable 

j resources in a remote system. The overheads involved in specifying 

j DTB=YES are not significant when recoverable resources are not 

j changed. Thus, the user may be well advised to specify DTB=YES for 

j all PCT entries, including those for tasks which do not modify 

1 protected resources. 

J • The transaction restart facility (provided by the RESTART=YES 
j parameter in the DFHPCT TYPE=ENTRY macro) may be used in 

j conjunction with dynamic transaction backout. 
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• Recoverable destinations should be specified by the DESTRCV=LG 
operand of the destination control table (DFHDCT). 

• Recoverable files should be specified by the LOG=YES operand of the 
file control table (DFHFCT). For files which use dynamic 
transaction backout support, the file control table entry must also 
include the reverse function to that specified in the SERVREQ 
operand. Thus, for example, if SERVREQ=NEWREC is specified for a 
file, SERVREQ=DELETE must also be specified. 

• The OPTGRP parameters, and relationships of individual PCT entries 
to the specific OPTGRP in support of VTAM message recovery, should 
be defined in the program control table (DFHPCT). 

• A temporary storage table suffix should be specified in the TST 
operand when generating the system initialization table CDFHSIT). 


CICS/VS EMERGENCY RESTART 


The following specifications should be made when generating CICS/VS 
emergency restart support: 

• A non-zero activity keypoint frequency must be specified in the 
AKPFREQ operand of the system initialization table (DFHSIT). 

• The device type (TAPE or DISK) of the system log must be specified 
in the JCT operand of the system initialization table. 

• The TST and KPP operands of the system initialization table must 
have suffixes specified. 

• Entries for the CSKP, CSLG and CSRS transactions should be included 

| in the program control table, either through DFHPCT 

| TYPE=ENTRY,TRANSID=xxxx or through the DFHPCT TYPE=GROUP, FN=AKP, 

j RESPLOG, and RESEND macros respectively. The last two transactions 

are only required if resynchronization of logical units is to be 
supported. 

• The type of recovery required should be specified in the DESTRCV 
operand of the DCT for each DCT entry. 

• Recoverable files should be indicated by the LOG=YES operand of the 
file control table (DFHFCT). 

• The journal control table (DFHJCT) should include the 
JFILEID=SYSTEM and JOUROPT=(CRUCIAL,INPUT) specifications. 

• The OPTGRP parameters, and relationships of individual PCT entries 
to the specific option groups in support of VTAM message recovery, 
should be defined in the program control table (DFHPCT). 

• Entries for DFHAKP, DFHRUP, DFHTBP, DFHTDRP, DFHTSRP, DFHUAKP, 
DFHZRLG and DFHZRSP must be made in the processing program table 

| either through DFHPPT TYPE=ENTRY,PROGRAM=name or through the 

j appropriate DFHPPT TYPE=GROUP,FN=function macro. 

• A temporary storage table (DFHTST) should be generated to specify 
the recoverable temporary storage DATAIDs. 


s 

J 
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I Chapter 3.4. Table Preparation for DL/I Facilities 


l 

I 

| This chapter provides details on how to include DL/I facilities in a 
| CICS/DOS/VS or a CICS/OS/VS system. 

I 

| DL/I WITH CICS/DOS/VS 


The specification of system table macros for DL/I support in CICS/DOS/VS 
requires the following steps: 

• Generation of the IMS/VS Data Base system as described in the DL/I 
DOS/VS Utilities and Guide for the System Programmer manual. 

• Generation of the CICS/DOS/VS system as described in Part 2 of this 
manual. 

• The DL/I DOS/VS application control table (ACT) must be generated - 
(refer to the DL/I DOS/VS Utilities and Guide for the system 
Programmer manual.) 

• An entry must be included in the file control table (PCT) for each 
DBD corresponding to a physical data base. The name of the DATASET 
parameters in the FCT and the DBD must be identical. 


| DL/I WITH CICS/OS/VS 


The specification of DL/I support in CICS/OS/VS requires the following 
steps: 


1. Generate the IMS/VS Data Base system (see the IMS/VS Version 1 
System Programming Reference Manual ), including the program 
specification blocks (PSBs) and the data base descriptors (DBDs). 

2. Generate the CICS/OS/VS system as described in Chapter 2.2 of this 
manual. 

3. Generate the required IMS/VS control blocks to define the DL/I 
system to CICS/OS/VS. 

a. Ensure that an entry is included in the file control table 
(FCT) for each DBD corresponding to a physical data base. The 
name of the DATASET parameters in the FCT and the DBD must be 
identical. Entries are also required in the file control table 
for data bases that are to be accessed from sharing batch 
regions through CICS/OS/VS. Physical, logical, and index data 
sets must be represented in DFHFCT and in DFHDLDBD if the 
CICS/VS master terminal facilities are to be used to close data 
bases. 

b. Define the following special requirements needed to generate 
DL/I program specification blocks (PSBs) when using DL/I under 
CICS/OS/VS. 
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(1) A special initialization PSB is used by CICS/VS-DL/I 
initialization to bring the proper DL/I modules into 
storage* This PSB, called the "initialization PSB", is not 
used by any transaction* Program communication blocks 
CPCBs) are defined within the PSB to indicate what type of 
CALLS and data bases DL/I will be called upon to service* 
The following rules apply: 


Define one data base PCB (TYPE=DB) for each of the 
following access methods to be used: HSAM, HDAM. 

Define one data base PCB for each of the following 
access methods to be used with VSAM: HISAM, HIDAM, 

HDAM, SHI SAM. 

Define two data base PCBs for the same data base for 
each of the following access methods to be used with 
ISAM: HISAM, HIDAM* These PCBs will be referred to as 

a PCB pair.Their specification causes BISAM rather than 
QISAM to be used. 

Within each PCB, define PROCOPT (processing options) to 
include all processing options to be performed against 
all the data bases using that access method. That is, 
if one HDAM data base is to be accessed via PROCOPT=GE 
and another via PROCOPT=GRP, the combined PROCOPT to be 
specified is PROCOPT=GRPE. 

For each PCB being defined, provide one SENSEG 
statement. For the PCB pairs required for HISAM or 
HIDAM with ISAM (see above), the SENSEG statements must 
refer to the same segment type. If the use of QISAM is 
desired in addition to BSAM, provide an additional 
SENSEG statement in one PCB of the PCB pair 

In the PCB statement, specify KEYLEN to be the length 
of the key field defined in the SENSEG statement in (e) 
above. 

The last statement preceding the END statement in the 
assembly should be written: 


PSBGEN LANG=ASSEM,PSBNAME=psbname 

If DL1=YES is specified during CICS/VS system 
initialization, the PSB used is named CICSPSB unless 
overridden in the system initialization table or by the 
execution time PSB parameter. 

If the CICS/OS/VS system is to handle requests for remote 
data bases only, no data-base processing will occur on the 
local system. In this case, no initialization PSB need be 
specified, but the system programmer must ensure that all 
the PSBs specified in the PDIR (see "Generate PDIR 
(DFHDLPSB)", below) are for remote PSBs. A DDIR, without 
an y DFHDLDBD TYPE=ENTRY statements, must be generated. 

When program isolation scheduling is used, there is no need 
for the user to create duplicate PSBs. More than one 
transaction can use the same update PSB. 
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If an application program wishes to access a PSB that 
resides on another CICS/OS/VS system, there must be an 
| entry for the PSB in the PDIR. The entry must specify the 

j SYSIDNT and MXSSASZ (and, optionally, RMTNAME) operands. 

(2) If an application programmer does not name a PSB in the 
DL/I CALL, the PSB used has the name of the program whose 
name is in the program control table (PCT) entry for this 
transaction. Therefore, for all transactions with DL/I 
CALLS where the PSB name is not specified, there must be a 
PSB generated with the same name as the program name in the 
PCT entry for the transaction. For PL/I programs, specify 
that the PSB is for PL/I. 

(3) If an application programmer names a PSB in the DL/I CALL, 
there must be a PSB generated with the name used in that 
CALL. For PL/I programs, specify that the PSB is for PL/I. 

| (4) If DL/I shared data base support is required, the following 

j system table macros and operands must be specified: 


• IRBUFSZ=value in DFHTCT TYPE=INITIAL 

• DFHTCT TYPE=IRCBCH,SESNUMB=number 

• IRCSTRT=YES in DFHSIT or CSMT IRC,BEGIN from the master 
terminal 

• DFHSIT,ISC=YES or xx, or as an override 

• DFHSIT,EXEC=YES (or default) 

• DFHPCT TYPE=GROUP,FN=ISC 

• DFHPPT TYPE=GROUP,FN=ISC. 


The CICS/OS/VS-DL/I interface uses the pre-built blocks feature of 
DL/I. After all program specification blocks (PSBs) and data base 
descriptions (DBDs) have been generated, the user must then generate 
application control blocks (ACBs) in the IMS/VS ACB Library for all PSBs 
| and DMBs to be used (including those that are to be accessed from 
j sharing batch regions through CICS/OS/VS). The instructions for this 
generation are included in the IMS/VS Utilities Reference Manual . 

A PSB directory (PDIR) list and a DMB directory (DDIR) list must be 
built for the CICS/VS-DL/I interface. Each of these lists is built by a 
separate assembly and link edit. 


| GENERATE PDIR (DFHDLPSB) 


The PDIR is generated by an assembly of DFHDLPSB macros as follows: 


r - 
| |DFHDLPSB| TYPE=INITIAL 

I I I t,DL/I=y.y.y] 

j j j [,SUFFIX=xx] 


I 

1 

I 


TYPE=INITIAL 

establishes the control section into which the PSB directory 
list is assembled. 
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indicates the IMS/VS level in the form: Version. Release. 
Modification level. Levels of IMS/VS prior to 1.1.2 are 
treated in one manner, and levels 1.1.2 and later are treated 
differently. 


SUFFIX—xx 

specifies a one- or two-character alphameric suffix (other than 
"NO" - which is reserved) for the PSB directory being 
assembled. This suffix, if specified, is appended to the 
standard module name (DFHPSB) and is used to name the module on 
the linkage editor output library. If the operand is omitted, 
a suffix is not provided. 


r 1 
| |DFHDLPSB| TYPE= ENTRY j 

I I | ,PSB=psbname j 

|j | | [,MXSSASZ=value] | 

|| j | (,RMTNAME=name] j 

| j I j t,SYSIDNT=namel | 

t---j 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
list. The maximum number of entries that can be included in the 
| list is 2000. 


PSB=psbname 

specifies the name of the program specification block (PSB). 
The PSBs required by IMS/VS batch application programs that 
participate in a shared data base session must be represented 
in this macro. 


MXSSASZ=value 

specifies the maximum size of a segment search argument to be 
used for this PSB. This operand is only required if the 
SYSIDNT operand is specified. 


RMTNAME=name 

indicates the name by which the PSB is known in the remote 
system and need only be specified when the SYSIDNT operand is 
used. The default is the psbname specified in the PSB operand. 
If the original application program that makes the request 
against this PSB is not on this system, or is a batch program 
using shared data base support, the PSB must be local to this 
system. Chaining of requests from one system to another is not 
allowed. 


SYSIDNT=name 

indicates the name of the remote system for which the PSB is 
applicable in an intersystem commmunication session. The name 
specified must be the same as that in the SYSIDNT operand in 
the TCT. The local system is assumed if this operand is 
omitted. 
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\ |DFHDLPSB| TYPE= FINAL ] 

l-J 


TYPE=FINAL 

indicates the end of the PSB directory list. 


| GENERATE DDIR (DFHDLDBD) 

The DDIR is generated by an assembly of the following DFHDLDBD macros: 

i 

I 
I 
I 

j 


r- 

| |DFHDLDBDJ TYPE=INITIAL 

| | | [,DL/I=y.y.y] 

| | j [,SUFFIX=xx3 

L- 


TYPE=INITIAL 

establishes the control section into which the DMB directory 
list is assembled. 


indicates the IMS/VS level in the form: Version. Release. 
Modification level. Levels of IMS/VS prior to 1.1.2 are 
treated in one manner, and levels 1.1.2 and later are treated 
differently. 


SUFFIX=xx 

specifies a one- or two-character alphameric suffix (other than 
"NO" - which is reserved) for the DMB directory being 
assembled. This suffix, if specified, is appended to the 
standard module name (DFHDMB) and is used to name the module in 
the linkage editor output library. If the operand is omitted, 
a suffix is not provided. 


r - 1 

| |DFHDLDBD| TYPE=ENTRY j 

j j j ,DBD=dbdname j 

i ---j 


TYPE=ENTRY 

specifies that one or more entries are to be generated in the 
list. The maximum number of entries that can be included in 
the list is 5000. 


DBD=dbdname 

specifies the name of the data base descriptor block (DBD). In 
a shared data base session, only those DBDs that reside in the 
given CICS/OS/VS system need appear in the DDIR. Thus, if an 
application program in the local system makes a request for a 
data base on a remote system, the corresponding DBD(s) need not 
appear in the DDIR for the local system. 

Note : If there are no local data bases on the CICS/OS/VS system (that 

is, if the DL/I application programs make requests for remote data bases 
only), a DDIR (with no TYPE=ENTRY statements) must still be generated. 
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| |DFHDLDBD| TYPE=FINAL j 

L----—-----J 


TYPE-FINAL 

indicates the end of the DMB directory list* 


RESTRICTIONS ON THE IMS/VS BATCH APPLICATION PROGRAMMER 


The IMS/VS batch application programmer must be aware of certain 
restrictions that exist when DL/I batch application programs run in a 
shared data base environment under CICS/OS/VS. These restrictions, 
which do not affect the CICS/VS application programmer, are as follows. 

Two types of DL/I requests may be issued by a batch application 
program: 

• All data base access calls (GUbb, GNbb, GNPb, GHUb, GHNP, GHNb, 
ISRT, DLET, and REPL) 

• System service calls - (CHKP and LOG only) 

IMS/VS application programs that use GSAM PCBs or PCBs with PROCOPT=L 
or LS (that is, those used for loading a data base) are not supported in 
the batch shared data base environment. 

In all other respects, IMS/VS batch application programs run 
satisfactorily in a shared data base session without being recompiled or 
re-linkedited. IMS/360 application programs, however, are not 
supported. The IMS/VS batch application programmer should be aware, 
however, that resources used by batch programs must be released as soon 
as possible (by means of CHKP calls) so that online programs are not 
delayed by waiting for these resources. 

Application programs that are used in a shared data base session may 
issue SPIE and STAE macros. When a DL/I request is made by the 
application program, the batch region controller modules will issue 
their own SPIE macro for the duration of the request, and will then 
restore the user's SPIE, if any. 

For information on all JCL changes that must be made to support the 
batch jobstream in CICS/OS/VS, refer to the CICS/VS System Programmers 
Guide (OS/VS). 
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Part 4. Recovery/Restart 




Chapter 4.1. Introduction 


This part of the manual describes the types of problems that can lead to 
CICS/VS recovery and restart facilities being used, the CICS/VS-provided 
functions to handle error conditions, and the facilities that are 
available to the system programmer to modify or extend these CICS/VS 
functions to suit the particular working environment. Figure 4.1 
summarizes the information in this part of the manual. 


r- 

| Error situation 

| CICS/VS function 

1 

1 

| Modifications avail- 
| able to the system 
| programmer 

| Chapter 

*1 

| Terminal error 

| Sample Terminal 

| User-written Terminal 



| (BTAM/TCAM) 

| Error Program 

i 

j Error Program 

i 

| 4.2 


| Logical unit 

1 

| Sample Node Error 

1 

| User-written Node 



j error (VTAM) 

| Program 

i 

| Error Program 

i 

| 4.3 


| Transaction 

| Abend exit 

1 

| User-written abend 



| abend 

j invocation 

| exit code 

| 4.4 



| Program error 

| User-written Program 




j program (DFHPEP) 

| Error Program 




1 Dynamic transaction! User-written DTB 




| backout 

| exit code 




j Transaction 

i 




j restart (DFHRTY) 

■ 

J User-written DFHRTY 

1 



| System abend 

1 

| Interception 

1 

| User-written SRT 

| 4.5 



j Sample SRT 

I 

| recovery code 

i 



| Journal 

1 

| Automatic journal- 

1 

| Journal services 

| 4.6 


| management 

1 ing 

i 




j Logging 

i 




j DL/I forward 

i 




j recovery 

l 

i 



| Warm restart 

i 

| Warm restart 

| 

l 

i 

| 4.7 


| Emergency 

1 

| Emergency restart 

1 

| Transaction backout 

| 4.8 


j Restart 

j with transaction 

j exits 




| backout 

| User-written activity 




1 

| keypoints 



| Multiprocessor 

1 

i 



j recovery 

1 

| Specific procedures 
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| Program check 

1 

| System recovery 

! 

| 4.10 


L- 

j program 
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-j 


Figure 4.1. Recovery/Restart Organization 
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Chapter 4.2. Terminal Error Program 


| This chapter contains information on the CICS/VS terminal error program 
j that handles error conditions for devices that operate in a non-SNA 
| environment. The CICS/VS-supplied sample terminal error program and the 
j user-written version(s) of this program are discussed, as well as error- 
J condition related information for specific device types. The 
j alternative terminal error program interface to CICS/VS, which provides 
j information on how to generate a terminal error program that can be used 
j on a pre-VS system, is also discussed. 

| CICS/VS terminal error-handling is based on the assumption that most 
j users will want to modify certain CICS/VS operations in response to 
j various terminal errors. Because it is impossible for CICS/VS to 
| anticipate all courses of action, the error-handling facilities have 
j been designed to allow maximum freedom in providing unique solutions for 
j errors occurring within a terminal network. 

| The following CICS/VS components are involved in the detection and 
j correction of errors that occur when BTAM and/or TCAM terminals are 
j used: 

| • Terminal error program (DFHTEP) 

| • Terminal control program (DFHTCP) 

| • Terminal abnormal condition program (DFHTACP) 

| The corresponding CICS/VS components for logical units are discussed 
| in Chapter 4.3, "The Node Error Program." 


| WHEN AN ABNORMAL CONDITION OCCURS 


| When an abnormal condition associated with a terminal or line occurs, 
| the terminal control program places the terminal out of service and 
| passes control to the terminal abnormal condition program (DFHTACP), 

| which, in turn, passes control to a version of the terminal error 
j program (DFHTEP) (either CICS/VS-supplied or user-written) so that it 
j can take the appropriate action. 


| TERMINAL CONTROL PROGRAM 


| When the terminal from which the error has been detected has been placed 
| out of service, the terminal control program creates a terminal abnormal 
| condition line entry (TACLE), which is chained off the real entry 
| (TCTLE) for the line on which the error occurred. The TACLE contains 
j all the error information necessary for proper evaluation of the error, 
j plus special action flags that can be manipulated to alter the error- 
| correction procedure. 
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| TERMINAL ABNORMAL CONDITION PROGRAM 


| After the TACLE has been established, a task that executes DFHTACP is 
| then attached by the terminal control program and is provided with a 
j pointer to the real line entry (TCTLE) on which the error occurred* 
j After performing certain basic error analyses and establishing default 
| actions to be taken, DFHTACP gives control to DFHTEP by issuing a 
I program control LINK request* DFHTACP passes the address of the TACLE 
j so that DFHTEP can examine the error and provide an alternative course 
| of action* 

| Once DFHTEP has performed the desired function, it returns control to 
| DFHTACP by issuing a program control RETURN request- DFHTACP then 
| performs the necessary actions as dictated by the action flags within 
| the TACLE; the error-handling task then terminates. 

I Note : Special consideration should be given to prevent data security 
j violation. For example, if a terminal is put out of service for some 
j time or until the cause of the failure is removed, the original operator 
| may no longer be present, although the sign-on information will still be 
j in the TCTTE when the terminal is put back into service. (See also the 
| note following "Format Description of the TACLE DSECT" under "Sample 
j Terminal Error Program Messages" later in this chapter.) 


| TERMINAL ERROR PROGRAM 


| The terminal error program analyzes the cause of the terminal or line 
| error that has been detected by the terminal control program. The 
| CICS/VS-supplied version (the sample terminal error program) is designed 
| to attempt basic and generalized recovery actions, while a user-written 
| version of this program can be provided to handle specific application- 
| dependent recovery actions. The user-written terminal error program is 
| linked to in the same way as the CICS/VS-supplied version by the 
| terminal abnormal condition program, and equally, information relating 
j to the error is carried in the terminal abnormal condition line entry 
| (TACLE). 

| The macros and operands that are provided for generating the sample 
| terminal error program are described in the sections that follow; the 
j main steps are generating the sample DFHTEP module and tables by means 
j of the DFHTEPM and DFHTEPT macros, respectively. The system programmer 
| can select the appropriate options in this sample program on which the 
j user-written version can be based. If so desired, a dummy terminal 
| error program, which invokes no action other than a program control 
j return operation to DFHTACP, can be generated by means of the DFHSG 
j PROGRAM=CSO macro described in Chapter 2.2. 

| A description of the CICS/VS-supplied sample terminal error program 
| appears later in this chapter; advice on how to generate a user-written 
j version is also given later in this chapter. 


| TERMINAL ABNORMAL CONDITION LINE ENTRY (TACLE) 


| The terminal abnormal condition line entry (TACLE) is the basic 
| interface that is used by the sample DFHTEP and should be used by a 
| user-written DFHTEP to determine the nature of the error that occurred 
| and to indicate what course of action is to be taken. 
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Before giving control to DFHTEP, DFHTACP establishes certain default 
actions to be taken, depending upon the particular error condition that 
has been detected. The default actions are indicated by appropriate bit 
settings in the one-byte fields of the TACLE labeled TCTLEECB+1 and 
TCTLEECB+2. The default actions and bit settings are listed in Appendix 
E. 


Note ; For a detailed discussion of these action bits, and the dummy 
terminal indicator, see the discussion under "User-Written Terminal 
Error Programs" later in this chapter. The write-abort bit (X'01" in 
TCTLEECB+1) is always set with the abend-task bit (X*04') as part of 
action 3, but both bits are suppressed if "dummy terminal" is indicated. 

The code indicating the particular error condition detected is passed 
to DFHTEP in the one-byte field of the TACLE labeled TCTLEPFL. These 
DFHTACP message codes, error codes, conditions, and DFHTACP default 
actions are also listed in Appendix E. 

A diagram of the terminal abnormal condition line entry (TACLE) DSECT 
is provided under "User-Written Terminal Error Programs" later in this 
chapter. 


THE SAMPLE TERMINAL ERROR PROGRAM 


CICS/VS provides a sample terminal error program (DFHTEP) that can be 
used as a generalized program structure for handling terminal errors. 
None of its components are generated as part of the standard CICS/VS 
generation process, but may instead be generated as described in this 
section. 

The user can generate and use the sample terminal error program with 
default options provided, or can tailor the terminal error support to 
the needs of the operating environment by selecting the appropriate 
generation options and variables. In addition, because each error 
condition is processed by a separate routine, the system programmer may 
replace a CICS/VS provided routine with a user-written one when the 
sample DFHTEP is generated. 


COMPONENTS 


The sample terminal error program consists of the terminal error program 
itself and two terminal error program tables: 

• The TEP error table 

• The TEP default table 

Both tables contain "threshold" limits defined for the various error 
conditions to be controlled and accounted for by the sample DFHTEP. A 
■threshold" limit may be thought of as the number of error occurrences 
that are permitted for a given type of error on a given terminal before 
the sample DFHTEP accepts the DFHTACP default actions. Optionally, the 
number of occurrences can be controlled and accounted for over¬ 
prescribed time intervals (for example, if more than three of a given 
type of error occur in an hour, the terminal will be placed out-of- 
service). 
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TEP Error Table 


The TEP error table maintains information about a terminal and the 
errors that have occurred on the terminal. The table consists of three 
parts, which are depicted in Figure 4.2-1, below. 

• TEP error table header - Contains addresses and constants related 
to the location and size of the TEP error table components. 

• Permanent and 

• Reusable terminal error blocks (TEBs) 

TEBs maintain error information associated with each terminal. The 
user is required to specify the total number of TEBs to be generated, 
and can permanently reserve TEB space for specific terminals that are 
critical to the system. Those TEBs that are not permanently reserved 
are considered reusable, and are assigned dynamically upon the first 
occurrence of an error associated with a particular terminal, and are 
released for reuse whenever the appropriate error processor places the 
terminal out-of-service. By reusing TEB space, the user normally 
requires fewer TEB entries than the total number of terminals in the 
network. 


TEP Error Table 
Header (TETH) 


Permanent 
Terminal 
Error Blocks 
(P-TEBS) 


Reusable 
Terminal 
Error Blocks 
(R-TEBs) 


| Figure 4.2-1. TEP Error Table 

Each TEB currently in use or permanently reserved contains the 
symbolic terminal identification assigned to the terminal and one or 
more error status elements (ESEs) as shown in Figure 4.2-2, below. An 
ESE records the occurrence of a particular type of error associated with 
| the terminal. The contents of an error status element are described in 
| the TEPCD DSECT (generated by the DFHTEPM TYPE=INITIAL macro) under the 
| comment "ERROR STATUS ELEMENT FORMAT". The number of ESEs per TEB 

remains constant for all TEBs and is specified by the user when the TEP 
tables are generated. If less than the maximum number of error types 
recognized by DFHTACP (25 for DOS/VS or 26 for OS/VS) is specified, one 
additional ESE, referred to as the common error bucket, is generated for 
each TEB. The user may permanently-reserve ESE space in each TEB for 
specific error types. Those not permanently reserved are considered 
reusable, and are assigned dynamically upon the first occurrence of a 
particular error type associated with the terminal. If an error type 
occurs that is not currently represented by an ESE, and if all reusable 
ESEs are assigned to other error types, the occurrence of this error is 
recorded in the common error bucket. The number of error types that can 
occur in a typical terminal network is far less than the number 
recognized by DFHTACP. By specifying less than the maximum and allowing 
the sample DFHTEP to assign ESEs dynamically, the user can minimize the 
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table size and still control and account for the types of errors 
relevant to the network. 


SYMBOLIC 

TERMINAL 

ID 


ERROR 

STATUS 

ELEMENT 


- 

• 

- 


COMMON 



ERROR 



BUCKET 



| Figure 4.2-2. Terminal Error Block (TEB) 


TEP Default Table 


The TEP default table contains the threshold limits for each type of 
error to be controlled and accounted for. An index array at the 
beginning of the default table serves a dual function. If the value in 
the index is positive, the error code has a permanently defined ESE in 
each TEB and the index value is the displacement to the reserved ESE. 

If the index value is negative, an ESE must be assigned dynamically from 
a reusable ESE if one has not already been created by a prior 
occurrence. The complement of the negative index value is the 
displacement to the threshold limits for the error type retained in the 
TEP default table. 


DESCRIPTION OF THE SAMPLE TERMINAL ERROR PROGRAM 

The structure of the sample terminal error program (DFHTEP) can be 
broken into six major areas as follows: 

• General entry and initialization 

• Terminal identification and error code lookup 

• Error processor selection 

• Error processing execution 

• General exit 

• Common subroutines 

These areas are described in detail in the sections that follow. 

| Figure 4.2-3 at the end of this section gives an overview of the 
| structure of the sample terminal error program. 
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General Entry and Initialization 


Upon entry, the sample DFHTEP establishes base registers and 
addressability to the various control blocks needed to process the error 
| (TACLE v TCTTE # TEP tables). If time support has been generated, an 
| interval control request is issued to timestamp the error for subsequent 
processing. The first entry into the sample DFHTEP after the system was 
initialized causes the TEP tables to be initialized. 


Terminal Identification and Error-Code Lookup 


After the general entry processing, the TEP error table is scanned for a 
terminal error block (TEB) entry for the terminal associated with the 
error. If no matching entry is found, a new TEB is created. If all 
TEBs are currently in use (if no reusable TEBs are available) the 
processing is terminated and a DFHPC RETURN request is issued giving 
control back to DFHTACP, where default actions are taken. Once the 
terminal's TEB has been located or created, a similar scan is made of 
the error status elements (ESEs) in the TEB to determine whether the 
type of error currently being processed has occurred before or if it has 
permanently-reserved ESE space. If an associated ESE is not found, an 
ESE is assigned for the error type from a reusable ESE- If a reusable 
ESE does not exist, the error is accounted for in the terminal's common 
error bucket. The addresses of the appropriate control areas (TEB and 
ESE) are placed in registers for use by the appropriate error processor. 


Error-Processor Selection 


User-specified message options are selected and the messages are written 
to a specified transient data destination. The type of error code is 
used as an index into a table to determine the address of an error 
processor to handle this type of error. If the error code is invalid or 
the sample DFHTEP was not generated to process this type of error, the 
address points to a routine which (optionally) generates an error 
message and returns control to DFHTACP, where default actions are taken. 
If an address of a valid error processor is obtained from the table, 
control is passed to that routine. 


Error Processing Execution 


The function of each error processor is to determine whether the default 
actions established by DFHTACP for a given error or the actions 
established by the error processor are to be performed. The common 
error bucket is processed by the specific error processor. However, the 
threshold limits of the common error bucket are used in determining 
whether the limit has been reached. Subroutines are provided in the 
sample DFHTEP to maintain count and time threshold totals for each error 
associated with a particular terminal to assist the error processor in 
making its decision. Also available are subroutines for logging the 
status of the error and any recovery action taken by the error 
processor. 
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The system programmer can replace any of the error processors 
supplied with the sample DFHTEP with user-written ones. Register 
linkage conventions, error conditions, DFHTACP default actions, and 
sample DFHTEP error processor actions are described in comments found in 
the sample DFHTEP source listing. However, sample DFHTEP actions, in 
many cases, can be altered by changing the threshold limits when 
generating the TEP tables. 


General Exit 


Control is passed to this routine from each error processor. This 
routine determines whether the terminal is to remain in service. If the 
terminal is to be put out-of-service, the terminal error block and all 
error status elements for that terminal will be deleted from the TEP 
error table unless the terminal was defined as a permanent entry. When 
the terminal is placed back in service, a new terminal error block will 
be assigned should a subsequent error occur. 


Common Subroutines 


A number of subroutines are provided in the sample DFHTEP for use by the 
error processors. Each subroutine entry has a label of the form 
"TEPxxxxx" where "xxxxx" is the subroutine name. All labels within a 
subroutine start with TEPx where "x" is the first character of the 
subroutine name. All subroutines are arranged within the module in 
alphabetical order in the subroutine section. Register conventions and 
use of the subroutine may be found as comments at the beginning of each 
subroutine in the source listing. The following subroutines are 
available to users who elect to write their own error processors: 

TEPACT 

Used to output the names of the action bits set by DFHTACP and 
the sample DFHTEP in the fields TCTLEECB+1 and TCTLEECB+ 2 of 
the TACLE if appropriate PRINT options are selected when the 
program is generated. 

TEPDEL 

Used to delete the terminal error block and error status 
elements for a terminal from the TEP error table on exit from 
an error processor. 

TEPHEXCN (Used by TEPPUTTD) 

Used to convert a four-bit hexadecimal value to its eight-bit 
printable equivalent. 

TEPINCR 

Used to update and test the count/time threshold totals 
maintained in the terminal's error status element. 

TEPLQC 

Used to locate or assign terminal error blocks and error status 
elements for a terminal identification. 

TEPPUTTD 

Used to output character or hexadecimal data to a user-defined 
transient data destination. 
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TEPTMCHK (Used by TEPINCR) 

Used to determine if the time threshold limit has expired. 

TEPWGHT 

Used to update the weight/time threshold values maintained in 
the terminal's error status elements. 


DFHTACP 



DFHTACP 

Figure 4.2-3. Sample DFHTEP Overview 


SAMPLE TERMINAL ERROR PROGRAM MESSAGES 


The messages logged to the transient data destination CSMT (or 
optionally, to the destination specified in the OPTIONS operand of 
DFHTEPM TYPE=INITIAL) are of six types, each identified by a unique 
message prefix. The selection of each type of message is controlled by 
the user through the appropriate parameters specified in the PRINT 
operand of DFHTEPM TYPE=INITIAL. These messages ares 
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DFHTEP, ERROR — error text 

During DFHTEP module generation, the PRINT parameter specified 
ERRORS. This message may be suppressed by using the NOERRORS 
option. The error text will be one of the following: 

Unsupported error code, "xx" 

The error code presented to DFHTEP by DFHTACP is unknown by 
DFHTEP. 

"DFHTEPT" not defined in system. 

The DFHTEP table could not be loaded into storage. 

Unknown error status message, "xxxx" 

The error status message presented from a remote 3270 type 
device could not be decoded. 

None of these errors should occur. 


DFHTEP, ACTION — action flag names 

During DFHTEP module generation, the PRINT parameter specified 
TACPACTION or TEPACTION or both. If both are specified, this 
message is logged twice each time DFHTEP is called. The first 
message indicates the action flags as set by DFHTACP on entry 
to DFHTEP- The second message indicates the action flags as 
returned to DFHTACP by DFHTEP after error processing. These 
messages may be suppressed by using the NOTACPACTION and 
NOTEPACTION options. 

The action flag names and descriptions are listed below. To better 
understand the actions taken by DFHTACP, see the discussion of the 
TCTTEECB+1 and TCTTEECB+2 fields contained in the TACLE DSECT 
description in "User-Written Terminal Error Programs" later in this 
chapter. 


LINEOS 

NO PURGE 

SW LINE DISCON 

DISCON SW LINE 

TERMOS 

ABEND 

NO POLL 

ABORTWR 

REL TCAM TIOA 


DFHTEP, TID — tid 

During the DFHTEP module generation the PRINT parameter 
specified TID. This message contains the symbolic terminal 
identification of the device associated with the error. This 
message may be suppressed by using the NOTID option. 


DFHTEP, DECB — DECB information 

During the DFHTEP module generation the PRINT parameter 
specified DECB. This two line message contains the DECB 
(printed in hexadecimal) of the terminal causing the error. 
The DECB is contained in the TACLE (displacement +16 
[decimal]). See the TACLE DSECT described in "User-Written 
Terminal Error Programs." This message may be suppressed by 
using the NODECB option. 


Line Out of Service 

Non-purgeable Task Exists on Terminal 
Switched Line Disconnected 
Disconnect Switched Line 
Terminal Out of Service 
Abend Transaction 

Take Control Unit Off Polling List 
Abort Write Request on Task abend 
Release TCAM TIOA (OS/VS only) 
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DFHTEP 


, TACLE — TACLE information 

During the DFHTEP module generation, the PRINT parameter 
specified TACLE. This message (printed in hexadecimal) will 
contain the first 16 bytes of the TACLE passed to DFHTEP by 
DFHTACP. See the TACLE DSECT described in "User-Written 
| Terminal Error Programs." This message may be suppressed by 

using the NOTACLE option. 


DFHTEP, ESE — ESE information 

During the DFHTEP module generation, the PRINT parameter 
specified ESE. This message contains the error status element. 
The message may be suppressed by using the NOESE option. 

An ESE will be either 6 bytes or 12 bytes long depending on whether the 
TIME option was specified when generating the TEP tables. Both formats 
are described below. 


NOTIME 

Displ. Length 


TIME 


0 

2 

4 

5 


2 Error threshold counter or weight value 

in binary 

2 Current error count or weight value in binary 

1 Error code 

1 Not used 


Displ. Length 


0 

5 

8 


5 Same as described in NOTIME above. 

3 Timed threshold value in hundredths 

of a second. 

4 Time of first occurrence of this 

error. Time given as binary integer 
in hundredths of a second. 


GENERATING THE SAMPLE TERMINAL ERROR PROGRAM 


| The sample DFHTEP and the TEP tables are generated independently of each 
j other. However, some of the parameters specified in the DFHTEPM and 
| DFHTEPT macro instructions are related and care must be taken to ensure 
j compatibility. The parameters concerned are identified in the 
j descriptions of the macros later in this chapter. 

If the sample DFHTEP is used, there are additional requirements which 
should be considered during PCT and PPT generation. These are as 
follows: 

1. The task executing the sample DFHTEP module requires a TWA of 10 
fullwords (forty bytes). This is in addition to any TWA 
requirement for DFHTACP. See transaction identification CSTE under 

| "Program Control Table" in Appendix A for the appropriate TWA size. 

2. The TEP table (DFHTEPT) must be specified in the PPT. The module 
should be specified with RES=YES, because once the table is loaded 
into storage, it is never deleted. If the module is specified with 
RES=YES it prevents the possibility of fragmenting the dynamic 

| area. See "Processing Program Table" in Appendix A. 
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Job Control for Generating the Sample Terminal Error Program 


The generation of the sample terminal error program consists of two 
separate assembly and link-edit steps, one to create the sample DFHTEP 
module itself, and the other to create the TEP tables. Refer to the 
information on the preparation of application programs in the 
appropriate CICS/VS System Programmer's Guide (OS/VS or DOS/VS) for the 
job control statements necessary to assemble and link-edit these 
components. The names under which the components must be link-edited 
are: 

DFHTEPM - Sample DFHTEP module 

DFHTEPT - Sample DFHTEP table 


Generate the Sample DFHTEP Module — DFHTEPM 


The sample DFHTEP module is generated by the following macro 
instructions: 

• DFHTEPM TYPE=INITIAL - to control the printing of CICS/VS DSECTs, 
provide optional routines, and indicate the type of information to 
be logged when errors occur 

• DFHTEPM TYPE= ERRPROC - to allow the user to replace the error 
processors supplied with the sample terminal error program with 
user-written versions 

• DFHTEPM TYPE=ENTRY - to code a user "ENTRY* exit 

• DFHTEPM TYPE=EXIT - to code a user "EXIT" exit 

• DFHTEPM TYPE=FINAL - to indicate the end of the sample DFHTEP 
module 



IDFHTEPM1 

TYPE=INITIAL 



1 

1 

[,DSECTPR= C YES|NO>] 



1 

1 

[,OPTIONS=UTD|(TD,destid)|NOTD] 



1 

1 

[,327OR I.NO3270R] 



1 

1 

[,77701.NO7770] 



1 

1 

C.EXITS I.NOEXITS] 



1 

I 

t,TIMEj.NOTIME] 



1 

1 

[,TCAM|,NOTCAM])] 



1 

1 

[.PRINT=([ERRORS!NOERRORS] 



1 

1 

[.TACPACTION1.NOTACPACTION] 



1 

1 

t.TEPACTION1.NOTEPACTIONJ 



1 

1 

[,TID|.NOTID] 



1 

1 

[,DECB|,NODECB] 



1 

1 

[.TACLEI,NOTACLE] 



1 

1 

[,ESE|.NOESE])] 



i- 


TYPE=INITIAL 

establishes the beginning of the generation of the sample 
DFHTEP module itself. 
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DSECTPR=YES1 NO 

is used to control the printing of CICS/VS DSECTs on the sample 
DFHTEP assembly listing. Its purpose is to reduce the size of 
the listing. The default is DSECTPR=YES. 

YES 

means that printing of the DSECTs will be allowed. 


means that printing of selected CICS/VS DSECTs will be 
suppressed. This parameter should not be used under 
Assembler F. 


OPTIONS=optional-routines 

is used to include or exclude optional routines in the DFHTEP 
module. The parentheses are required even when only one option 
is specified. If this operand is omitted all default options 
are generated. Valid options are: 

TD or (TD, destid) or NOTD 

is used to specify whether information regarding the errors 
is to be written to a transient data destination. 

TD 

means the transient data output routine is to be 
generated. The implied transient data destination is 
CSMT. 

(TD f destid) 

means the transient data output routine is to be 
generated. The messages are sent to the destination 
specified by "destid". (See the DESTID operand in the 
DFHDCT TYPE=EXTRA macro instruction in Chapter 3.2 of 
this manual.) 


NOTD 

means no messages are to be written to a transient data 
destination. 

3270R or NO3270R 

is used to specify whether optional remote 3270 support is 
to be included. 

3270R 

means remote 3270 errors are to be supported. More 
specifically, error codes 89 and 9D are supported. If 
the user wishes to supply his own error processor 
routines for these codes, 3270R must be specified or 
allowed to default. 

NO3270R 

means no remote 3270 support is to be generated. 

7770 or NO7770 

is used to specify whether optional 7770 support is to be 
included. 

7770 

means 7770 errors are to be supported. More 
specifically error code 8A is supported. If the user 
wishes to supply his own error processor routine for 
this code, 7770 must be specified or allowed to 
default. 
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NO7770 

means no 7770 support is to be generated. 

EXITS or NOEXITS 

is used to specify whether "ENTRY 11 and "EXIT" user exit 
support is to be included. The default is NOEXITS. 

EXITS 

means that branches will be taken to ENTRY and EXIT 
exit routines before and after error processing. Dummy 
exits are provided if user exits are not used. 

NOEXITS 

indicates that no branches will be taken to user exit 
routines. 

TIME or NOTIME 

is used to specify whether threshold limit tests are to be 
controlled over prescribed time intervals. An example 
might be placing a terminal out-of-service if more than 
three instances of a given type of error occur in one hour. 
The parameter must be the same as the OPTIONS operand in 
the DFHTEPT TYPE=INITIAL macro instruction. 

TIME 

means this type of "threshold" testing is to be 
supported. 

NOTIME 

means this type of "threshold" testing is not to be 
generated. 

TCAM or NOTCAM 

is used to specify whether optional TCAM support is to be 
included (CICS/OS/VS only). 

TCAM 

indicates that TCAM error code * 9F* is to be supported. 
NOTCAM 

indicates that TCAM error code W 9F* is not supported. 


PRINT=print-information 

is used to specify which types of information are to be logged 
to the transient data destination each time an error occurs. 

If NOTD is specified on the OPTIONS operand, all PRINT 
parameters default to NO. All PRINT parameters require the 
transient data output routine. The parentheses are required 
even when only one parameter is specified. 

ERRORS or NOERRORS 

is used to specify whether unprocessable conditions 
detected by the sample DFHTEP are to be recorded on the 
transient data destination. 

ERRORS 

means error messages are to be logged. 

NOERRORS 

means no error messages are to be logged. 

TACPACTION or NOTACPACTION 

is used to specify whether DFHTACP default actions are to 
be recorded on the transient data destination. 
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TACPACTIQN 

means the default actions are to be logged. 

NOTACPACTION 

means no default actions are to be logged. 

TEPACTION or NOTEPACTION 

is used to specify whether the actions selected as a result 
of sample DFHTEP processing are to be recorded on the 
transient data destination. 

TEPACTION 

means the final actions are to be logged. 

NOTEPACTION 

means no final actions are to be logged. 

TID or NOTID 

is used to specify whether the symbolic terminal 
identification of the terminal associated with an error is 
to be recorded on the transient data destination. 

TID 

means the terminal identification is to be logged. 

This is the default parameter. 

NOTID 

means no terminal identifications are to be logged. 

DECB or NODECB 

is used to specify whether the DECB of the line associated 
with error is to be recorded on the transient data 
destination. 

DECB 

means the DECB is to be logged. The hex representation 
of the DECB is logged as two 24-byte messages. This is 
the default parameter. 

NODECB 

means no DECB logging is to occur. 

TACLE or NOTACLE 

is used to specify whether the TACLE prefix is to be 
recorded on the transient data destination. 

TACLE 

means the 16-byte TACLE prefix as received from DFHTACP 
is to be logged. This is the default parameter. 

NOTACLE 

means no TACLE prefix logging is to occur. 

I 

ESE or NOESE 

is used to specify whether the ESE associated with the 
error is to be recorded on the transient data destination. 

ESE 

means the ESE, after being updated, and before being 
deleted (if the action puts the terminal out-of- 
service) is to be logged. This is the default 
parameter. 

NOESE 

means no ESE logging is to occur. 
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Error Processor Source 


Comments contained in the sample DFHTEP provide guidance on how to 
prepare error processor routines, particularly with regard to register 
and subroutine linkage conventions. The routines must also adhere to 
the following restrictions: 

• The error processor must be coded in assembler language. 

• The first executable statement in the routine must be labeled 
TEPCDxx where xx is the error code specified in the DFHTEPM 
TYPE=ERRPROC r CODE=errcode macro instruction, which follows. 

• In addition to the register usage conventions and restrictions 
stated in the sample DFHTEP source, the contents of registers 12 
and 13 (TCA and CSA base registers) must not be disturbed. The 
sample DFHTEP executes as a group of non terminal-dependent tasks 
under ClCS/VS, and each has its own TCA during the processing of 
each terminal error. 

• The error processor must exit to the sample DFHTEP symbolic label 
TEPRET. 

The macro instruction required for a user "ENTRY" exit is: 


r-r-r-1 

j |DFHTEPM| TYPE=ENTRY | 

L-L_L_-_-___J 

This macro must be immediately followed by user "ENTRY" exit code, 
starting with the label "TEPENTRY" and ending with a BR 14 instruction. 

The macro instruction required for a user "EXIT" exit is: 


j |dfhtepm[ type=exit 


— 1 




This macro must be immediately followed by user "EXIT" exit code, 
starting with the label "TEPEXIT" and ending with a BR 14 instruction. 


I Replace Error Processors — DFHTEPM TYPE=ERRPROC 


The macro instruction necessary to replace error processors supplied 
with the sample DFHTEP with user-written error processors is as follows: 


r- r - r - 

| |DFHTEPM j TYPE=ERRPROC 

J j | ,CODE=errcode 

| j j (followed by the appropriate error 

j j | processor source statements) 


I 

I 


I 

i 
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TYPE=ERRPROC 

indicates that a CICS/VS-supplied error processor routine is to 
be replaced with the user-written error processor which 
immediately follows the macro instruction. This macro 
instruction is optional; if used, the macro must follow the 
DFHTEPM TYPE=INITIAL macro. One DFHTEPM TYPE=ERRPROC macro 
must precede each user-written error processor source routine. 


CODE=errcode 

is used to identify the error code assigned to the appropriate 
error condition. These codes are listed in the section "Format 
Description of TACLE DSECT." As an example, the 7770 timeout 
error condition would be entered as CODE=8A. 


| End of Sample DFHTEP Module — DFHTEPM TYPE=FINAL 


The macro instruction to terminate the sample DFHTEP module is: 


r - r - r - 

| j DFHTEPM| TYPE=FINAL 

L— -L-L—- 


1 

I 

J 


DFHTEPM Macro Examples 


1. The following is an example of the minimum number of statements 
required to generate a sample DFHTEP module: 

DFHTEPM TYPE-INITIAL 

DFHTEPM TYPE=FINAL 

END 

This example generates a sample DFHTEP module with CICS/VS-supplied 
error processors and all default options. 

2. The following is an example of a more tailored sample DFHTEP 
module: 
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* MODULE SPECIFICATIONS 


DFHTEPM TYPE=INITIAL, * 

OPTIONS=((TD,TEPQ),NO7770,EXITS), * 

PRINT=(NOTEPACTION,NOTACPACTION), * 

DSECTPR=NO 

* USER-SUPPLIED ERROR PROCESSORS 
DFHTEPM TYPE=ERRPROC,CODE=81 

TEPCD81 DS OH 

error processor "SI" source statements 


B 

DFHTEPM 
TEPCD9C DS 


TEPRET 

TYPE=ERRPROC,CODE=9C 
OH 


error processor "9C" source statements 


B TEPRET 

* USER "EXIT" EXIT CODE 
DFHTEPM TYPE=EXIT 

TEPEXIT DS OH 


Additional user source statements to be executed after error processings 


BR R14 

* CONCLUDE MODULE GENERATION 

DFHTEPM TYPE^FINAL 

END 

In this example no 7770 support is generated, but remote 3270 support 
and time interval "threshold" testing support are provided- All default 
types of information except for TACP and TEP actions are to be logged to 
the TEPQ transient data destination. The CICS/VS DSECTs will not be 
printed on the sample DFHTEP assembler listing. The user has supplied 
two error processor routines (codes 81 and 9C respectively). 


I Generate the Sample DFHTEP Tables — DFHTEPT 


The following macro instructions are required to generate the terminal 
error program tables: 

| • DFHTEPT TYPE=INITIAL - to establish the control section 
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| • DFHTEPT TYPE=PERMTID - to define permanently reserved terminal 

| error blocks (TEBs) for specific terminals 

| • DFHTEPT TYPE=PERMCODE|ERRCODE - to define permanently reserved 

j error status elements (ESEs) 

| • DFHTEPT TYPE=BUCKET - to account for specific error conditions to 
j be accounted for in the common error bucket 

| • DFHTEPT TYPE=FINAL - to end the set of DFHTEPT macros 


Control Section — DFHTEPT TYPE=INITIAL 


The DFHTEPT TYPE=INITIAL macro instruction necessary to establish the 
control section for the TEP tables is: 


r-r-r- 

j |DFHTEPT| TYPE=INITIAL 

j j j ,MAXTIDS=number 

j j j t.MAXERRS={25 (DOS/VS) or 26 (OS/VS)|number>J 

| j j I,OPTIONS= C TIME I NOTIME}] 

t-L-L--- 


’I 

I 

I 

I 

I 


TYPE=INITIAL 

establishes the beginning of the generation of the TEP tables. 


MAXTIDS=number 

is used to specify the total number of permanent and reusable 
terminal error blocks to be generated in the TEP error table. 
Permanent entries are defined by the DFHTEPT TYPE=PERMTID macro 
instruction described later in this section. Any entries not 
defined as permanent will be reused when the terminal is taken 
out of service, or will be deleted at the request of an error 
processor. If an error occurs, and no TEB space is available, 
the error is not processed, and DFHTACP default actions are 
taken. The minimum number is 1. A maximum number is not 
checked for but should be no greater than the number of 
terminals in the user's network. This parameter is required . 


MAXERRS=number 

is used to specify the number of errors to be recorded for each 
terminal. This value determines the number of permanent and 
reusable error status elements in each TEB. The maximum number 
which may be specified is 25 for DOS/VS and 26 for OS/VS. 

(These are also the default values.) If more are requested, 
only the maximum will be generated. If fewer are requested, 
one extra ESE will be generated for each TEB. The extra ESE is 
the common error bucket. Permanently reserved ESEs are defined 
by the DFHTEPT TYPE= PERMCODE macro instruction described later 
in this section. Any ESEs not defined as permanent will be 
dynamically assigned upon the first occurrence of a non- 
permanent error type associated with the terminal. By defining 
a number less than the maximum, and allowing the sample DFHTEP 
to dynamically assign ESEs, the user can minimize the size of 
the table and still control and account for the error types 
relevant to the network. The minimum number that can be 
specified is zero. In this case only a common error bucket 
will be generated. 
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OPTIONS= TIME | NOTIME 

is used to specify whether time threshold space is to be 
reserved in support of the TIME option specified in the DFHTEPM 
TYPE=INITIAL macro instruction. The default is OPTIONS=TIME. 

TIME 

means time threshold space will be reserved. 

NOTIME 

means time threshold space will not be reserved. 


Define Terminal Error Blocks — DFHTEPT TYPE=PERMTID 


The DFHTEPT TYPE=PERMTID macro instruction to define permanently 
reserved terminal error blocks for specific terminals is as follows: 


r- r - r - 

j j DFHTEPT j TYPE=PERMTID 

| j | ,TRMIDNT=name 

L-l_ L_ 


1 


I 

I 


J 


TYPE=PERMTID 

defines permanently reserved terminal error blocks for specific 
terminals. Permanent TEBs are defined for terminals that are 
critical to system operation to ensure that error processors 
will always be executed in the event of errors associated with 
that terminal. If no permanent TEBs are to be defined this 
macro instruction is not required. A separate macro 
instruction must be issued for each permanently reserved TEB. 
The maximum number of permanent TEBs is the number specified in 
the MAXTIDS operand of the DFHTEPT TYPE=INITIAL macro 
instruction. 


TRMIDNT=name 

is used to provide the one- to four-character symbolic terminal 
identification for a permanently defined TEB. Only one 
terminal may be specified in each macro. 


Define Error Status Elements — DFHTEPT TYPE-PERMCODEIERRCODE 


The DFHTEPT TYPE=PERMCODE|ERRCODE macro instruction used to change the 
default threshold constants of the sample DFHTEP, and to define 
permanently reserved error status elements, is as follows: 


r- r - r - 

j jDFHTEPTj TYPE={PERMC0DE|ERRCODE} 

j j | ,CODE={errcode|BUCKET} 

j | | [,COUNT=number] 

j | | [,TIME=(number{,SEC|,MIN|,HRS})3 

L-L-L- 


I 

I 

I 

I 


_j 
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TYPE= PERMCODE|ERRCODE 

identifies whether the error code specified in the macro 
instruction is to have a permanently reserved or a dynamically 
assigned ESE. These macros are only required if no permanently 
reserved ESEs are to be defined, or if the sample DFHTEP 
default threshold constants are not to be overridden. These 
are listed in Figure 4.2-4 below. 

PERMCODE 

identifies the error code specified as having a permanently 
reserved ESE. Each permanently reserved ESE must be 
identified by a separate DFHTEPT TYPE=PERMCODE macro 
instruction. All DFHTEPT TYPE=PERMCODE macros must precede 
all DFHTEPT TYPE=ERRCODE macros. 

ERRCODE 

indicates that the error code specified does not require a 
permanently-reserved ESE, but that the sample DFHTEP 
default threshold constants are to be changed. Each error 
code requiring a threshold constant change, other than 
those defined as permanently-reserved, must be identified 
by a separate DFHTEPT TYPE=ERRCODE instruction. All 
DFHTEPT TYPE= ERRCODE macros must follow all DFHTEPT 
TYPE=PERMCODE macros. 


CODE^errcode 

identifies the error code referred to by the 

TYPE=PERMCODE|ERRCODE parameter. These codes are listed in the 
section "Format Description of TACLE DSECT." As an example the 
7770 timeout error condition would be entered as CODE=8A. 

CODE=BUCKET is only applicable to the DFHTEPT TYPE=ERRCODE 
macro instruction. It is used to override the default 
threshold constants established for the common error bucket. 


COUNT=number 

may be used in either the DFHTEPT TYPE=PERMCODE or TYPE=ERRCODE 
macro instruction to override the sample DFHTEP default 
threshold count limits (see Figure 4.2-4). When the number of 
occurrences of the error type specified reaches the threshold 
limit, an error processor would normally take a logic path that 
would cause DFHTACP default actions to be taken. If the number 
of occurrences is less than the threshold limit, the error 
processor would normally take a logic path that would override 
the DFHTACP default actions. The updating and testing of the 
current threshold counts are normally performed by a DFHTEP 
subroutine, which sets a condition code that the error 
processor can test to determine whether the limit has been 
reached. If the user specifies zero as the number in the COUNT 
operand, the threshold limit will never be indicated as having 
been reached. 
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TIME=time options 

may be used in either the DFHTEPT TYPE=PERMCODE or TYPE=ERRC0DE 
macro instructions to override the sample DFHTEP default 
threshold time limits (see Figure 4.2-4). This parameter is 
only applicable when the OPTIONS=TIME parameter is specified in 
both the DFHTEPM and DFHTEPT TYPE=INITIAL macro instructions. 
When the number of occurrences reaches the threshold limit 
specified in the COUNT=parameter (above) within the interval of 
time specified in this parameter, an error processor would 
normally take a logic path that would cause DFHTACP default 
actions to be taken. If the number of occurrences within the 
time interval is less than the threshold limit, the error 
processor would normally take a logic path that would override 
the DFHTACP default actions. If the time interval has expired, 
the sample DFHTEP subroutine that normally updates and tests 
the current threshold count resets the occurrence counts and 
establishes a new expiration time. In this case the condition 
code set by the subroutine would indicate that the threshold 
limits had not been reached. Time control in the sample DFHTEP 
starts with the first occurrence of the error type. Subsequent 
occurrences of the same error type do not establish new 
starting times, but are merely accounted for as having occurred 
within the interval started with the first occurrence. This 
continues until an error count reaches the threshold limit 
within the interval started with the first occurrence, or until 
the interval has expired. In the latter case, the error being 
processed becomes a first occurrence, and a new interval is 
started. A time interval of zero means that the number of 
occurrences is to be accounted for and controlled without 
regard to a time interval. Zero is the implied time interval 
if the C0UNT=parameter is zero or 1. It is also the implied 
time interval if the time options are not generated. 

The time interval may be expressed in any one of four units; 
hours, minutes, seconds, or hundredths of seconds. This allows 
the user to express fractional parts of a unit as whole units 
at a lower level. As an example, 1-1/2 minutes could be 
expressed as 90 seconds, or even 9000/100ths seconds. The 
maximum interval must be the equivalent of less than 24 hours. 
While the smallest interval that can be expressed is l/100th 
second, a practical minimum would be 1 to 2 minutes. This 
allows for access method retries, plus the time required to 
create the task required to service each error. The four 
methods of expressing the threshold time interval ares 

number 

expresses the interval in l/100th-second units. 

Parentheses are not required if this method is used. The 
maximum number must be less than 8,640,000 (24 hours). 

(number,SEC) 

expresses the interval in whole seconds and must be 
enclosed in parentheses. The maximum number must be less 
than 86,400 (24 hours). 

(number,MIN) 

expresses the interval in whole minutes, and must be 
enclosed in parentheses. The maximum number must be less 
than 1,440 (24 hours). 

(number,HRS) 

is used to express the interval in whole hours, and must be 
enclosed in parentheses. The maximum number must be less 
than 24 hours. 
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| The following table illustrates the sample terminal error program 
J default threshold count limits referred to in the TYPE, COUNT, and TIME 
j operands of the DFHTEPT TYPE=PERMCODE|ERRCODE macro instruction. 


r 

j CODE= 

| COUNT= 

| TIME= 

| CODE= 1 

COUNT= 

| TIME= 


i 8i 

1 3 

I (7,MIN) 

| 94 

1 7 

I (10 f MIN) 9 


| 84 

1 1 

1 0 

| 95** 

1 o 

1 8 


1 85 

1 1 

I 0 

1 96 

1 2 

I (1,MIN) 


| 86 

| 1 

1 0 

| 97** 

1 o 

1 8 


j 87*** 

1 50* 

1 0 

| 98 

| 5 

I (5,MIN) 


| 88 

1 1 

1 0 

| 99 

1 1 

1 8 


| 89 

| 100* 

| (7 f MIN) 

| 9B 

1 1 

1 8 


j 8A 

1 2 

j (2,MIN) 

| 9C 

I 1 

1 8 


| 8B** 

I o 

1 o 

| 9D 

1 5 

j (5, MIN) 


| 8C 

| 1 

1 o 

| 9E 

1 o 

1 8 



1 

1 

j 9F** 

1 8 

1 o 


| 8D 

1 1 

1 o 

| AO** 

1 o 

1 8 


| 8E 

i i 

1 o 

| Al** 

1 8 

1 8 


j 8F 

1 i 

1 0 

| BUCKET 

| 5 

| (5,MIN) 


L - 



rr -r -n- 



- j 


♦Error processor uses a threshold "weight" instead of a threshold count 
(see sample DFHTEP source listing).. 

♦♦Error processor maintains error count only. DFHTACP default actions 
are always taken regardless of the threshold limits. 

♦♦♦For TCAM conditions without TACP defaults, TEP retries 5 times and 
releases TIOA. Otherwise the default TACP actions are taken. 

| Figure 4.2-4. Sample DFHTEP Threshold Default Limits 


Account for Specific Error Conditions — DFHTEPT TYPE=BUCKET 

The macro instruction used to cause specific error conditions to always 
be accounted for in the common error bucket is as follows: 

r-r-r-■-1 

| jDFHTEPT| TYPE=BUCKET | 

j | | ,CODE=errcode | 

L__ l_L_i 


TYPE=BUCKET 

generates the macro to account for specific error conditions. 

If MAXERR=25 (DOS/VS) or 26 (OS/VS) is specified in the DFHTEPT 
TYPE=INITIAL macro instruction, this macro instruction is 
invalid. This macro is only required if no error codes are to 
be specifically accounted for in the common error bucket. Each 
error code must be specifically identified by a separate 
DFHTEPT TYPE=BUCKET macro instruction. 


CODE=errcode 

identifies the error code to be specifically accounted for in 
the common error bucket. The error code must not be specified 
in the DFHTEPT TYPE=PERMCODE or TYPE=ERRCODE macro instruction. 
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Terminate DFHTEPT Macro 


DFHTEPT TYPE=FINAL 


The DFHTEPT TYPE=FINAL macro instruction terminates the generation of 
the DFHTEP tables. 


|DFHTEPT1 TYPE=FINAL 
1 • 


DFHTEPT Macro Examples 


1. The following is an example of the minimum number of statements 
required to generate the TEP tables: 

DFHTEPT TYPE=INITIAL,MAXTIDS=10 

DFHTEPT TYPE=FINAL 

END 

This example generates ten reusable terminal error blocks, each 
capable of accounting for the maximum number of error types. 
Time "threshold" control is supported, and all "threshold" 
values are the defaults supported by the sample DFHTEP. 

2. The following is an example of a tailored TEP table: 


* TABLE SPECIFICATIONS 

DFHTEPT TYPE=INITIAL,MAXTIDS=10, * 

MAXERRS=5 

* PERMANENT TERMINAL DEFINITIONS 

DFHTEPT TYPE=PERMTID,TRMIDNT=TMO 2 

* PERMANENT ERROR CODE DEFINITIONS 

DFHTEPT TYPE=PERMCODE,CODE= 81 

DFHTEPT TYPE=PERMCODE,CODE=87, * 

COUNT= 2,TIME-(1,MIN) 

* OTHER THRESHOLD OVERRIDES 

DFHTEPT TYPE=ERRCODE,CODE=BUCKET, * 

COUNT=3,TIME=(3,MIN) 

* CONCLUDE TABLE GENERATION 

DFHTEPT TYPE=FINAL 

END 

This example generates ten terminal error blocks, one of which 
is reserved for the terminal whose symbolic identification is 
TM02, and the other nine being reusable. Each TEB has space 
for five error status elements plus a common error bucket. Of 
the five ESEs, two are reserved for error codes 81 and 87; the 
remaining ESEs are available to be assigned dynamically. The 
threshold limits for error code 87 and the common error bucket 
are being changed. No specific error code is to be accounted 
for in the common error bucket. 
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USER-WRITTEN TERMINAL ERROR PROGRAMS 


A user-written terminal error program may be generated. The user- 
written DFHTEP then replaces the dummy DFHTEP provided during in the 
DFHSG PROGRAM=CSO macro. The user-written DFHTEP will receive control 
as described at the start of this chapter, and therefore should use the 
TACLE as its basic interface with DFHTACP. 

Users of releases of CICS/VS prior to Version 1.1.1 should note that 
their existing terminal error programs may require modification to run 
on subsequent releases of CICS/VS. The TCTLEPTE field is now a full 
word direct pointer to the TCTTE of the terminal which produces the 
error. Previously, this was a halfword binary displacement which, when 
added to the true line entry address (TCTLEDCB), gave the correct TCTTE 
address. 

There are some situations in which CICS/VS may attempt to send a 
message to an input-only terminal; for example, an invalid transaction 
identification message, an ATP batch count, or a message erroneously 
sent by an application program. The user should provide a terminal 
error program to reroute these messages to a system destination such as 
CSMT or CSTL or other destinations by means of transient data or 
interval control facilities. 

A similar situation can exist when a message is sent to a 3735 
terminal operating as an input batch device. An attempt to write to the 
3735 before the receipt of the end of transmission (EOT) gives control 
to DFHTACP. If no DFHTEP is provided, the current transaction will 
abend and the line will be disconnected. 


ADDRESSING THE CONTENTS OF THE TACLE 


When DFHTEP receives control from DFHTACP, the TCA facility control 
address (TCAFCAAA) contains the address of a TACLE. The TACLE is 
created by the terminal control program when the error occurs and 
contains all the I/O error information provided by BTAM or TCAM. 

To address the contents of the TACLE, the user-written terminal error 
program should contain the statements "COPY DFHTACLE" and "COPY 
DFHTCTLE" in that order. These define the complete DFHTCTLE DSECT. The 
symbolic names in this DSECT are used to address fields in both the 
TACLE and the real line entry associated with the error. 

The TACLE consists of a 16-byte prefix (defined by "COPY DFHTACLE") 
and a further 48-byte section, which is a modified copy of the DECB of 
the real line entry at the time the TACLE was created. 

To address the TACLE, the user-written terminal error program should 
contain the statements: 


L TCTLEAR, TCAFCAAA POINT TO TACLE 

USING DFHTCTLE,TCTLEAR 

Note that fields normally part of the real line entry DECB have 
offsets increased by 16 in the TACLE. 
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The following fields in the DECB copy in the TACLE do not represent 
data copies from the real line entry: 


TCTLEDCB (OS/VS) (Offset 24 in TACLE, 

TCTLEDTF (DOS/VS) 8 in real TCTLE) 

This field in the TACLE points to the real line entry, whereas in the 
real line entry it points to the BTAM DCB (OS/VS) or DTF (DOS/VS) for 
the line group. 


TCTLEECB+1 (Offsets 17, 18 in TACLE, 

TCTLEECB+2 1,2 in real TCTLE) 

These fields in the TACLE are used as interface bytes for the 
terminal abnormal condition program. 


TCTLECB+3 (Offset 19 in TACLE, 

3 in real TCTLE) 

This is used in the TACLE for BTAM return code on rejected I/O requests. 

TCTLECSW (Offsets 46, 48 in TACLE, 

TCTLEALP 30, 32 in real TCTLE) 

These are used in the TACLE for SAM error information, apart from their 
normal use for BTAM lines. 

Given addressability to the TACLE, the user may also address the real 
line entry (for example to inspect data not in the DECB copy) by coding; 


L TCTLEAR,TCTLEDTF (DOS/VS), or. 

L TCTLEAR,TCTLEDCD (OS/VS) 

USING DFHTCTLE + TCTLEECB,TCTLEAR 

Note: The real line entry storage definition starts at TCTLEECB, 16 

bytes after TCTLEPSA, and continues beyond the DECB end (TCTLESI). 

To revert to addressing the TACLE, the user should re-code: 


L TCTLEAR,TCAFCAAA POINT TO TACLE 

USING DFHTCTLE,TCTLEAR ADDRESS TACLE 

Extreme care should be taken to ensure that the correct 
addressability is established when referencing fields in the DFHTCTLE 
DSECT• 

Note : In programs that do not require a reference to the TACLE, the 

following statements give direct addressability to the real line entry: 

COPY DFHTCTLE 


COPY 

DFHTCTTE 




L 

TCTTEAR, TCAFCAAA 

POINT 

TO 

TCTTE 

L 

TCTLEAR, TCTTELEA 

POINT 

TO 

TCTLE 

USING 

DFHTCTLE,TCTLEAR 

ADDRESS TCTLE 


In this case the TACLE prefix is not mentioned and DSECT DFHTCTLE 
begins with field TCTLEECB. 
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Once ttye user has performed the functions desired, and optionally 
altered the default actions scheduled by DFHTACP, the user-written 
DFHTEP must return control to DFHTACP by issuing the program control 
RETURN request. DFHTACP then performs the actions specified in the 
TACLE and causes the error processing task to terminate. 


FORMAT DESCRIPTION OF TACLE DSECT 

TERMINAL ABNORMAL CONDITION LINE ENTRY 


Dec . 

0 


4 

8 

12 

16 

20 


24 


28 


44 


48 

60 


r --- 1 

* * 

Hex .* <-4 BYTES- >* 

* * 

0 ***************************************************** 

* TCTLEPSA * 

* * 

* STORAGE ACCOUNTING AREA * 

4 *- * 

* TCTLEPCH * 

* * 

♦ ADDRESS OF TRANSIENT DATA OUTPUT AREA * 

8 *---* 

* TCTLEPFL * TCTLEPF2 * * 

♦ * * NOT USED * 

* ERROR FLAGS * SPECIAL IND * * 

C *-* 

* TCTLEPTE * 

♦ * 

* TCTTE ADDRESS * 

10 *-* 

* TCTLEECB * * * BTAM/TCAM * 

* BEGINNING * ACTION *RESERVED * RETURN * 

* OF DECB * FLAGS *FOR DFHTACP* CODE * 

14 *-* 

* * 

* * 

♦ * 

18 *--* 

* TCTLEDCB (OS/VS only) * 

* or TCTLEDTF (DOS/VS only) * 

* ACTUAL LINE ENTRY ADDRESS * 

1C *-* 

* * 

♦ * 

* * 

2C *-* 

* * TCTLECSW * 

* NOT USED - * * 

* * BSAM STATUS * 

30 *-* 

* TCTLEALP * * 

* BSAM * * 

* SENSE * * 

3C *-* 

* * 

* TCTLEOA * 

* * 


***************************************************** 
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Displacement 


Dec. 

Hex. 

Code 

Bytes 

Label Meaninq 

0 

0 


4 


TCTLEPSA Storage accounting 

4 

4 


4 


TCTLEPCH Pointer to 100 bytes of user 






storage that can be used to 
write to transient data 






(first 8 bytes reserved for 
storage accounting). 

This storage must not be 
freed by DFHTEP, as DFHTACP 
may reuse it. 

8 

8 


1 


TCTLEPFL Error flags 



81 



Message too long 



83 



TCEMCAAR 2740-2 auto output request 



84 



TCT search error 



85 



Invalid write 



86 



Polling list error 



87 



Unsolicited input 



88 



Input event rejected 



89 



Status message received 



8A 



7770 32-second timeout 



8B 



Hardware buffer exceeded 



8C 



Output event rejected 



8D 



Output length of zero 



8E 



No output area 



8F 



Output area exceeded 



94 



Unit check 



95 



Unit check (should not occur) 



96 



Unit exception 



97 



Unit exception (should not 
occur) 



98 



Negative response 



99 



Undetermined I/O error 



9B 



Copy error (3270) 



9C 



Invalid message block 



9D 



Incomplete message 



9E 



No printer available for 

3270 print request 



9F 



Invalid destination (TCAM) 



AO 



Invalid read 



A1 



Invalid disconnect 



• 

(All 

codes not listed are reserved) 

9 

9 



1 

TCTLEPF2 Special indicator 



01 



dummy terminal 

12 

C 



44 

TCTLEPTE Address of terminal entry 






for terminal in error 

16 

10 



48 

TCTLEECB DECB/copy of line when 






error occurred 

60 

3C 



4 

TCTLEOA For TCAM lines only. 


Address of the line 
I/O area containing 
the input or output message, 
or zero if none available 
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TACLE ACTION AND INFORMATION BITS 


| The following definition of the DECB area includes TCTLEECB+1 which 
j contains the action bits (0, 3, 4, 5, 6, and 7) and information bits (1 
and 2). This is the only portion of the copy of the DECB that can be 
altered. These bits are located at label TCTLEECB+1. 


Dec. 

Hex. 


Bytes 

Label 

Meaning 

17 

11 


1 

TCTLEECB+1 

Interface byte 



Bit 0 


0... .... 

Place line in service 





1... .... 

Place line out of service 



Bit 1 


. 0 . • .... 

Information bit 

Not used 





.1.. _ 

Nonpurgeable task exists 
on terminal 



Bit 2 


..0. 

Information Bit 

Not used 





.•1. . 1 . . . 

Switched line has been 
disconnected by BTAM 



Bit 3 


... 0 .... 

Do not disconnect line 





...1 .... 

Disconnect line 



Bit 4 


.. . . O.i. . 

Place terminal in service 





• • • • la*. 

Place terminal out of service 



Bit 5 


.... .0.. 

Do not abend task 





• . . . . 1 * . 

abend task 



Bit 6 


.... ..0. 

Leave terminal's associated 
control unit on poll list 





.... . . 1 . 

Take terminal's associated 
control unit off poll list 



Bit 7 


.... ... 0 

Do not abort WRITE or 






free terminal storage 
on task abend, or no task 
present on terminal 





.... ... 1 

Abort terminal WRITE 






requests and free terminal 
storage on task abend or 
no task present on terminal 

18 

12 


1 

TCTLEECB+2 

Interface byte 2 



Bit 0 


1... .i. .. 

Release TCAM incoming message 



Bits 1-7 



Reserved 

19 

13 


1 

TCTLEECB+3 

BTAM return code 

24 

18 


4 

TCTLEDCB 
(OS/VS) or 

Actual line entry address 





TCTLEDTF (DOS/VS) 

46 

2E 


2 

TCTLECSW 

BSAM status 

48 

30 


1 

TCTLEALP 

BSAM sense 


The following factors should be considered when altering the action 
bits in the TACLE: 

• For TCAM unsolicited input errors with either the terminal out of 
service or in receive-only state, a loop will occur if the default 
action of purging the incoming message does not occur and the 
status of the terminal is not altered. 
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• The dummy terminal indicator at TCTLEPF2 is set on errors such ass 
(1) BTAM return on input, (2) binary synchronous outputs performed 
for TCP where no terminal is indicated, and (3) other errors from 
which no specific terminal is indicated. Therefore, if dummy 
terminal is indicated, task abend and write abort are not set (see 
below). The dummy terminal is only used to identify the line. 

• The ••switched line disconnected" bit (X*20* at TCTLEECB+1) is used 
by DFHTACP upon return from DFHTEP to logically disconnect (by 
issuing a WRITE BREAK) the switched line that has been physically 
disconnected by BTAM. If DFHTEP determines that the line has not 
been physically disconnected, DFHTEP may reset this bit. DFHTCP 
can communicate this disconnect condition for BISYNC lines to 
DFHTACP by setting the bit TCBSWB in the field TCTLEDI in the real 
line entry. DFHTCP will do this when a READ INITIAL or READ 
CONNECT completes with an I/O error or when a mandatory disconnect 
sequence <DLE-EOT) is received from the remote terminal. OS/VS 
BTAM may DISABLE a switched line and convey this fact by setting 
the bit X*08r in the field TCTLEES. This flag may be tested in the 
TACLE. 

• The "disconnect switched line" bit (X*10 f at TCTLEECB+1) is used by 
DFHTEP to request that DFHTACP actually makes the disconnection (by 
means of a WRITE DISCONNECT). 

• If the "switched line disconnected" bit or the "disconnect switched 
line" bit is on, upon return from DFHTEP, the "task abend" bit 
should also be set to purge the task from the disconnected 
terminal, if this is the case and if the task is not purgeable 
from the terminal, DFHTACP writes an INTERCEPT REQUIRED message to 
destination CSMT and places the terminal out of service. 

• The "abend transaction" bit iX'Q 1 *' in TCTLEECB+2) is always 
associated with two other bits as part of TACP action 3. These 
other bits are "non-purgeable task" and "write abort" (X*40* and 
X’Ol" respectively, both in TCTLEECB+1)• 

• "Write abort" is always set on at the same time as "abend 
transaction". It has the effect of clearing the TCTTE of the 
original write request indicators, if the error being processed 
occurred on a TC WRITE. 

• "Non-purgeable task" is set on if a transaction is currently 
associated with the terminal, but if this transaction ID was 
specified with TPURGE=NO in the PCT. 

• None of "abend task", "Write abort", or "non-purgeable task" bits 
will be set if the dummy terminal indicator is on, even if DFHTACP 
would normally set default action 3 (abend transaction) for the 
error being processed. The following remarks only apply, 
therefore, to errors related to a real terminal. 

• "Abend task" has no effect if no transaction is associated with the 
terminal. Otherwise, if "non-purgeable task" is indicated, the 
transaction remains attached to the terminal (normally in SUSPEND 
state) and DFHTACP writes the DFH2522 INTERCEPT REQUIRED message to 
CSMT; if the transaction is not marked "non-purgeable", it is 
abended with code ATAI, or rarely, ATAD. 

• "Write abort" has no effect if the TCTTE was associated with a READ 
request. In this case the normal result will be that, if the line 
and terminal remain in service, the read will be retried. 
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| EXAMPLE OF A USER-WRITTEN TERMINAL ERROR PROGRAM 


Following is an example of the steps of logic necessary to design a 
portion of the terminal error program, and has been called the "DFHTEP 
Recursive Retry Routine". In this example ten retries are provided for 
each terminal? however, the logic could be used for any number of 
retries. The following assumptions are made: 

USER FIELD A 
(PCISAVE) 

Represents a six-byte field in the process control 
information (PCI) area of the TCTTE (see the TCT macro 
definition of the TCTUAL operand). This field is used to 
preserve the count of input and output from the TCTTE when 
the first error occurs. These counts are contained in 
three-byte fields located at TCTTENI and TCTTENO within the 
TCTTE. 


USER FIELD B 
(PCICNT) 

Represents a user-defined field used to accumulate the 
count of recursive errors. It would most likely be in the 
process control information (PCI) area of the TCTTE. 


SYSTEM COUNT 
(TCTTENI) 

Represents the six-byte field in the TCTTE that contains 
the terminal input and output counts (TCTTENI+TCTTENO). In 
the example, these two adjacent fields are considered as 
one six-byte field. 

Because this example requires access to the TCT terminal entry 
(TCTTE) to examine the SYSTEM COUNT and to also locate the process 
control information (PCI) area, the DFHTCTTE symbolic storage definition 
is included so that fields may be symbolically referenced. 


CICS/VS System Programmer's Reference Manual 


354 




DFHTEP Recursive Retry Routine 


************************************************************************ 
* * 

* DFHTEP RECURSIVE RETRY ROUTINE * 

* * 
************************************************************************ 


TEPBAR 

EQU 

2 

TCTTEAR 

EQU 

9 

PCIBAR 

EQU 

8 


DFHTCA 


COPY 

EJECT 

DFHTCTTE 


COPY 

DFHTACLE 


COPY 

EJECT 

DFHTCTLE 

PCIAREA 

DSECT 


PCISAVE 

DS 

6X 

PCICNT 

DS 

EJECT 

PL 2 

DFHTEP 

CSECT 



BALR 

TEPBAR,0 


USING 

*,TEPBAR 


L 

TCTLEAR,TCAFCAAA 


L 

TCTTEAR,TCTLEPTE 

* 


L 

PCIBAR,TCTTECIA 


USING 

PCIAREA,PCIBAR 


TM 

PCICNT+1,X*0C* 

♦ 

* 


BO 

CKCOUNT 

* 

* 

RESET 

MVC 

PCICNT,=PL2'* + 0' 

* 


MVC 

PCISAVE(6),TCTTENI 

* 

* 

INCR 

AP 

PCICNT,=P”1* 

* 

* 


CP 

PCICNT,=P*10' 

* 


BNE 

RETRY 

* 


ZAP 

PCICNT,=P"O' 


MVC 

PCISAVE(6),TCTTENI 


B 

NORETRY 

CKCOUNT 

CLC 

PCISAVE(6),TCTTENI 

* 


BNE 

RESET 


* 

♦ 

* 


B INCR 

* 

* 

* 

RETRY DS OH 


NORETRY DS OH 


TEP PROGRAM BASE 
BASE REGISTER FOR TCTTE 
BASE FOR PCI 
TASK CONTROL AREA 
COPY TCTTE DEFINITION 

COPY TACLE SYMBOLIC DEFINITIONS 
COPY DECB DEFINITION 


USER FIELD A 
USER FIELD B 


ESTABLISH PROGRAM ADDRESSABILITY 

LOAD TACLE ADDRESS 
LOAD TCTTE BASE WITH 
TCTTE ADDRESS 
LOAD PCI AREA ADDRESS 
ESTABLISH ADDRESSABILITY 
HAS USER FIELD B EVER BEEN 
INITIALIZED TO A PACKED 
DECIMAL NUMBER? 

. . YES, SO COMPARE THE 
SYSTEM COUNT WITH THE 
EXISTING COUNT IN FIELD B; 

.. NO, SO INITIALIZE FIELD 
B TO A PACKED DECIMAL 0. 

SAVE THE CURRENT SYSTEM 
COUNTS. THIS IS A NEW 
ERROR, OR FIRST TIME THROUGH 
INCREMENT THE NUMBER OF 
TIMES THIS SAME ERROR HAS 
OCCURRED. (RECURSIVE COUNT) 

HAS THE MAXIMUM RECURSIVE 
ERROR LIMIT BEEN REACHED? 

.. NO, SET ACTION 
INDICATORS FOR RETRY ATTEMPT 

* CLEAR AND RESET USER FIELDS 

♦ FOR NEXT ERROR SET 

ACTION INDICATORS FOR NO-RETRY. 
HAS SYSTEM COUNT CHANGED SINCE 
LAST ENTRY TO TEP? 

.. YES; THAT MEANS THIS IS 
A NEW ERROR SINCE SOME I/O 
ACTIVITY HAS OCCURRED ON 
TERMINAL 

.. NO; THAT MEANS THIS IS A 
RECURSIVE ERROR, SO 
INCREMENT THE RECURSIVE COUNT 
AND CHECK FOR RETRY. 

THE USER WOULD INCLUDE HERE 
THE CODE NECESSARY TO ALTER 
THE FLAGS IN THE TACLE SO 
THAT A RETRY CAN BE PERFORMED 
ON THE TERMINAL. 

THE USER WOULD INCLUDE HERE 
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. THE CODE NECESSARY TO ALLOW 

. DFHTACP TO TAKE FINAL ACTION 

ON THE TERMINAL (I.E., ABEND 
TASK, PUT LINE OUT OF SERVICE, 
ETC. ) 

LTORG 

END 

The above example is intended only to serve as an illustration of a 
recursive error handling technique and the steps necessary to establish 
addressability to the applicable control blocks. 

Note: To prevent data security violation (for example, when a terminal 
has been put out of service and the operator leaves that terminal, the 
master terminal may put that terminal back into service and another 
operator may use the terminal with the original operator f s security 
key), the following code may be included in the DFHTEP (for example, 
after the label "NORETRY" in the example above) to provide an automatic 
sign-off: 

NI TCTTETS,255-TCTTESTA 

XC TCTTEOI,TCTTEOI 
MVC TCTTESK,TEPESK 
SP TCTTEOT,TCTTEOT 

SP TCTTEOE,TCTTTEOE 


TEPESK DC BL(L*TCTTESK)* 1* 

After providing addressability to every terminal entry, similar 
actions may be performed for every terminal on a line that is taken out 
of service. 


DFHTEP ALTERNATE INTERFACE (CICS/OS/VS ONLY) 


An alternate interface is provided in CICS/OS/VS to maintain 
compatibility with the CICS/OS-STANDARD Version 1 user who currently has 
code dependent upon this interface. This interface is provided when the 
user specifies V1CMPAT=YES in the DFHSG TYPE=CSO macro instruction 
during system generation. 

When an error is detected, control is passed to DFHTEP for analysis; 
the TWA contains the following information: 


BYTES 

LABEL 

DEFINITION 



1 

TWACOBA 

Contains 

the 

status byte from BTAM 


1 

TWACOBA+1 

Contains 

the 

sense byte from BTAM 


1 

TWACOBA+2 

Contains 

issued 

the 

teleprocessing OP code 

being 

1 

TWACOBA+3 

Reserved 




4 

TWACOBA+ 4 

Contains the transaction identification, 
if one exists, for the terminal in error 

The 

user-written DFHTEP 

must place 

the 

line or terminal in service. 


or out of service if so desired. If the task is to be abnormally 


RESET TERMINAL ATTENDED 
CLEAR OPERATOR ID 
RESET SECURITY KEY 

RESET NUMBER OF VALID TRANSACTIONS 
RESET NUMBER OF TRANSACTION ERRORS 
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terminated, DFHTEP must place a X W FE* at label TWACOBA before returning 
control to DFHTACP• 


| USER-WRITTEN ACTIONS FOR PARTICULAR CASES 

| This section provides guidance on how to write a user-written terminal 
j error program to handle error conditions from several devices. The 
| following topics are discussed: 

| • Switched BSC temporary text delay (TTD) 

| • 7770 32-second timeout 

| • 2740 model 2 

| • Teletypewriter (WTC only 

| • 3270 unavailable printer 

| • 3600 BSC 

| • 3275 dialed 30-second timeout 

| • 3270 locked buffer 


Switched BSC Temporary Text Delay (TTD) 


When a temporary text delay indication is received, BTAM, after retrying 
the operation up to seven times, will turn on TCTLESF7 (TCTLESF^X"01 1 ) 
and return control to CICS/VS indicating that an error has occurred. 
CICS/VS will then invoke DFHTEP for error analysis. 

BTAM may also turn on TCTLESF7 when a data record ending with ENQ is 
received (the terminal detected a parity or transparency error). 
Therefore, DFHTEP should also examine the I/O area pointed to by 
TCTLEIOA to determine if it contains STX ETX (TTD) or EOT ...data... 

ENQ. 


7770 32-second Timeout 


If a terminal connected to the 7770 Audio Response Unit goes "on hook" 
while no I/O operation is outstanding, the 7770 does not present the 
unit exception to the channel. This situation can occur when the 
terminal operator makes an inquiry and hangs up before receiving a 
response. After this occurs, all writes to the line appear to complete 
normally. All reads complete normally at the end of the 32-second 
timeout with a zero data length. 

When a 32-second timeout occurs, either the terminal operator has not 
entered anything for 32 seconds, or the terminal operator has hung up 
and the 7770 did not inform CICS/VS. CICS/VS cannot distinguish between 
these two conditions; therefore, CICS/VS handles every 32-second timeout 
as an error condition. DFHTACP goes to DFHTEP with defaults of 
DISCONNECT SWITCHED LINE and ABEND THE TRANSACTION. If DFHTEP does not 
disconnect the switched line, CICS/VS writes the "ready" message and 
initiates another read. 
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2740 Model 2 


When DFHTACP detects a negative response from a 2740 Model 2, the write 
operation will be retried after a ten second time delay if the user- 
written TEP has been coded to retry the write. This delay allows for 
operator reaction time etc. If the delay time factor is to be changed, 
this may be done by storing the new time delay factor at TCTTEBC. The 
value is a positive binary number representing hundredths of a second 
(ten seconds would have a value of F f 1000 f or X f 000003E8') which is 
calculated by adding the delay value to the value contained in CSACSCC. 
The cause of the negative response may be determined by examining the 
field TCTLERSP. The contents of TCTLERSP and the meaning of each 
follows 

X f 04* Terminal in bid mode 

X f 02* Terminal in communicate mode 

X 1 20* Terminal in communicate mode with document device down 
X*10 * Terminal in local mode 

X"13 B Terminal in communicate mode but out of paper 
X" 08* Contents of buffer are being printed 

Caution: Failure to set a long enough time delay may cause a loop at 
the terminal and pressing the reset key will not be recognized. 


Teletypewriter (WTC only) 


There are no default actions provided by DFHTEP for the Teletypewriter 
(WTC only). All exceptional conditions have to be handled by the user. 
In the case of an ID error or a severe transmission error, he may want 
to abend the task and disconnect the line so that the computer is able 
to accept a new connection. Under these circumstances it is recommended 
that after entry to DFHTEP, the interface byte for the status of the 
task, line, and terminal, (that is, TCTLEECB+1) be set to the following 
values before returning to DFHTACP: 


Bits 01234567 
Values 0 

* 


0 



line in service 
unchanged 

switched line disconnect 
request "off" 

disconnect line 

terminal in service 

abend task 

unchanged 

unchanged 
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3270 Unavailable Printer 


This condition arises when a print request is made through the 3270 
print request facility and there are no printers on the control unit or 
the printer(s> is in one of the following conditions: 

• out of service 

• A task is presently attached 

• Currently busy on a previous operation 

• Intervention required 

The terminal control program recognizes this condition and issues a 
READ BUFFER operation to collect the data into a line I/O area. The 
LIOA is of the same format as a TIOA would be if an application program 
J had issued a terminal control read buffer request; thus, the TIOA DSECT 
may be used to reference the LIOA. 

The TCP then obtains a TACLE and attaches DFHTACP with the error code 
X"9E" (TCEMCUP). The TACLE fields relevant to this situation are: 


TCTLEIOA - Pointer to the LIOA 

TCTLETLA-1 - Pointer to first printer on control unit or 
zero (no printers) 

DFHTACP writes the DFH2508 UNAVAILABLE PRINTER message to the CSMT 
destination and LINKS to DFHTEP with no default actions set. 

On return from DFHTEP, DFHTACP will perform the following actions, 
based on the field TCTLETLA in the TACLE: 

1. If TCTLETLA-1 is all FFs (-1 set by DFHTEP) DFHTACP assumes that 
DFHTEP has disposed of the data to be printed and desires the 
keyboard of the originating terminal to be restored. 

2. If TCTLETLA-1 is 0 (zero) DFHTACP will assume that no printer is 
available, and the keyboard of the originating terminal will not be 
restored. 

3. If TCTLETLA-1 is neither 0 (zero) nor -1 (all FFs) DFHTACP assumes 
that TCTLETLA-1 is the address of a printer. An interval control 
PUT will be performed to the provided terminal. The transaction to 
be initiated is CSPP (print program), and the time interval will be 

j zero. If CSSP is to be scheduled, AUTOTRN=YES must be specified in 

j DFHSG PROGRAM=TCP to include the AVAIL logic. 

a. If an error occurs on the interval control PUT, DFHTACP will 
write the DFH2531 IC FAILURE message to the destination CSTL. 
DFHTACP will then link to TEP again with the high order bit 
(X* 80*) set in the TACLE field, TCTLETLA-1, and the IC error 
value from the TCA field TCAICTR is placed into the TACLE 
field, TCTLEECB+ 3. This is done in order for TEP to have a 
last chance to dispose of the data. On the second RETURN from 
TEP to DFHTACP, DFHTACP will reexamine TCTLETLA-1. If 
TCTLETLA-1 is -1 (all FFs), DFHTACP will restore the keyboard 
of the originating terminal, otherwise, the keyboard will 
remain locked. 

b. If no error occurred on the interval control PUT, DFHTACP will 
check for the following printer conditions: 
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(1) Out of service 


(2) Intervention required 

(3) Other than RECEIVE or TRANSCEIVE status 

If one of these conditions is true, DFHTACP will issue the 
DFH2513 PRINT QUEUED message to the destination CSMT. 

4. DFHTACP will then terminate any PRINT requests on the originating 
terminal, free the LIOA, and perform normal action flag processing 
on the originating terminal. 

Note that all scheduling and error handling for 3270 printers 
operating under TCAM is provided by the message handler. 


3600 BSC 


There is no special default processing provided in DFHTEP for BTAM- 
supported 3600 BSC terminals. 


I 3275 Dialed 30-second Timeout 

| In some countries, a legal requirement exists which prohibits a switched 
| line from remaining connected for more than 30 seconds if no line 
j activity is taking place. This action is initiated by the modem (for 
j example, WTC 3976-3) dropping DSR and going on hook. In this situation, 
| CICS/VS will disconnect the line and manual intervention may be required 
| to reestablish the connection. 


I 3270 Locked Buffer 

| To prevent data displayed on a 3270 display from being copied to a 3270 
| printer, the "from" buffer can be locked by placing a protected 
J alphanumeric attribute byte (BIT2=1, BIT3=0) in address 0. This will 
j cause any attempted copy command to end with sense status X* C4C1*. For 
j further information, refer to the 3270 Information Display System 
I Component Description Manual . 
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Chapter 4.3. Node Error Program 


| As with the terminal error program for non-VTAM devices, the node error 
| program for logical units is available in two forms; the CICS/VS- 
| supplied sample node error program, and the user-written version(s). 
j Both types are discussed in the following sections. 


| WHEN AN ABNORMAL CONDITION OCCURS 


| The following CICS/VS components are involved when an abnormal condition 
| is detected from a logical unit: 

| • The terminal control program VTAM portion — DFHZCP 

| • The node abnormal condition program — DFHZNAC 

| • The CICS/VS-supplied sample node error program, or the user-written 

| version(s) of that program (DFHZNEP) 

| The implementation of error-processing for logical units is such that 
I any error detected by the VTAM portion of the terminal control program 
| is routed to the node abnormal condition program (DFHZNAC). The node 
j abnormal condition program issues messages and sets flags appropriate to 
| the kind of error that has occurred, and passes control to the 
| appropriate node error program (DFHZNEP). After taking whatever action 
| is necessary, the node error program returns control to the node 
j abnormal condition program via a program control RETURN operation. 

| For further details on node error programs, refer to Appendix E for a 
| list of the error conditions and appropriate node abnormal condition 
| program action flag settings, and to Chapter 5.2 of this manual. 


| THE SAMPLE NODE ERROR PROGRAM 


The CICS/VS sample node error program is a generalized program structure 
for handling errors detected from logical units. None of its components 
are generated as part of the standard CICS/VS generation process, but 
instead may be optionally generated as described in this section. 

The sample node error program provides a general environment for the 
execution of error processing routines (error processors) each of which 
is specific to certain error codes generated by the node abnormal 
condition program. Optional error processors, sufficient for normal 
operation of VTAM 3270 or interactive logical unit networks, are 
provided; these can be easily supplemented or replaced by user-supplied 
processors. 

The type of errors that may occur in a VTAM network are threefold: 

• Errors in the host system. 

• Communication errors, such as session failures.. 

• Abnormal conditions at the terminal, such as intervention required 
and invalid requests. 
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A sample node error program is supplied with CICS/VS, which may be 
used as the basis of each subsequent user-written node error program. 
This provides the user with: 

• A general enviroment within which user-written error processing 
programs may be easily added 

• Fundamental error recovery actions for a VTAM 3270 network which 
are consistent with those provided in the sample terminal error 
program for a BTAM 3270 network 

• The default node error program in a system that has several node 
error programs 

The CICS/VS-supplied sample node error program is described in 
greater detail below. 


COMPATIBILITY WITH THE SAMPLE TERMINAL ERROR PROGRAM 


The default error processors for VTAM 3270s in the sample node error 
program provide facilities for error handling similar to those for BTAM 
3270s that are processed by the sample terminal error program. 

Receipt of sense/status corresponds to error codes X'D^ 1 , X'DC", and 
X f DD *. Weighted counts of these messages are maintained against numeric 
and time thresholds. If the numeric threshold is exceeded, default 
actions are taken. If the time threshold is reached, the count is 
reset. This is equivalent to the function in the sample TEP, except 
that sense/status arising out of the "from" device on a COPY command is 
now presented to the node error program as an error on the "to" device, 
thus exceeding the threshold, which causes the request to be terminated, 
although the terminal remains in service. Some of the weights for 
| errors that occur on the 3270 display have been revised, otherwise the 
weight and threshold values are the same as the defaults used in the 
sample TEP. Time threshold maintenance is mandatory and not optional as 
in the sample TEP. 

| For further on time and threshold count limits, refer to the 
| information on the sample terminal error program in Chapter 4.2. 

3270 "unavailable printer" corresponds to error code X*42* (interval 
control PUT request has failed. The algorithm used for printer 
selection differs in VTAM support; the retry algorithm in the sample 
node error program is appropriate to this new selection algorithm. 


COMPONENTS 

The sample node error program comprises the following components: 

• The Routing Mechanism 

• The Node Error Table 

• Optional Common Subroutines 
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• Optional Error Processors for 3270 or Optional Error Processor for 
interactive logical units. A node error program cannot be 
generated with both 3270 and interactive logical unit error 
processors. 

The components are described below. 


Routing Mechanism 


The routing mechanism invokes the appropriate error processor depending 
on the node abnormal condition program error code. 

Groups of one or more error codes are defined in the DFHSNEP macro 
(see below). Each group is associated with an index (in the range X f 01* 
through X'FF 1 ) and an error processor. A translate table is generated 
and the group index is placed at the appropriate offset for each error 
code. Error codes not defined in groups have a zero value in the table. 
An error processor vector table (EPVT) contains the addresses of the 
error group processors, positioned according to their indexes. The 
vector table extends up to the maximum index defined; undefined 
intermediate values are represented by zero addresses. 

On entry to the sample node error program, initialization establishes 
addressability to the node error table (NET) and, if included, the 
common subroutine vector table (CSVT). The error code is translated to 
obtain the error group index. A zero value causes the node error 
program to take no further action, otherwise the index is used to obtain 
the address of the appropriate error processor from the EPVT. A zero 
address causes the node error program to take no further action, 
otherwise a call is made to the error processor. This is entered with 
direct addressability to the following areas: NET, TCTTE, TCA, CSA, and 
| CSVT. After execution of the error processor, the node error program 
j returns control to the node abnormal condition program. 


Node Error Table 

The node error program may use a node error table (NET) which comprises 
node error blocks (NEBs) that are used to maintain error status 
information for individual nodes (see Figure 4.3). Some or all of the 
NEBs may be permanently reserved for specific nodes, others are 
dynamically assigned to nodes when errors occur. The latter are used 
exclusively for the nodes to which they are assigned until they are 
explicitly released. All the NEBs have an identical structure of error 
status blocks (ESBs). Each ESB is reserved for one error processor and 
associated with it by means of the appropriate error group index. The 
ESB length and format may be tailored to the particular error processor 
that it serves. 
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NEB 


NET 


PERMANENTLY- 
l ASSIGNED 
f NEBS 


DYNAMICALLY- 
L ASSIGNED 
r NEBs 


| Figure 4.3. Format of Node Error Table and Node Error Block 


r- 1 

NODE ERROR 
BLOCK HEADER 


ERROR STATUS 
BLOCK 


> ESBS 


r - 1 

| NODE ERROR 
| TABLE HEADER 

| NODE ERROR 
| BLOCK 


Optional Common Subroutines 


The common subroutines are addressed via the CSVT and provide error 
processors with the following functions: 

1. Locate or assign NEBs and ESBs on the basis of node identification 
and error group index. 

2. Timestamp an error, update an error count, and test an error count 
against numeric and time threshold values. 

3. Release a dynamically-assigned NEB from a particular node. 


Optional Error Processors for 3270 Logical Units 


Two error processors are supplied as follows: 

• Group index 1, error codes X*D9*, X f DC f , and X"DD f . 

These error codes correspond to the receipt of sense/status bytes 
in the user sense fields of the RPL. The error processor locates 
an ESB of the standard format and updates a weighted error count. 
The weight, threshold, and timer values are based on those used by 
the sample terminal error program for a BTAM 3270 except as noted 
in the previous section. If the threshold is not exceeded, the 
"abort send", "abort receive", "abend transaction" bits, and all 
the print action flags are turned off. Otherwise the default 
actions are taken and the NEB released if reusable. 
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• Group index 2, error code X*42". 

This code means that no 3270 printer was available to satisfy a 
PRINT request made at a 3270 screen. The error processor examines 
the printers defined for this screen to determine why they were 
unavailable. If either is busy on a previous PRINT or COPY request 
(that is, a task is attached with transaction id of CSPP or CSCY) 
or is no longer unavailable, that printer address is returned to 
the node abnormal condition program which will retry the PRINT 
request with an IC PUT command, otherwise the default actions are 
taken. (For more details see the section M 3270 Unavailable 
Printer" later in this chapter.) 


Optional Error Processor for Interactive Logical Units 


• Group index 1, error codes X*DC* . 

This error code, in combination with a user sense value of X* QQ1B ', 
indicates a "receiver in transmit code" condition. The action 
flags are manipulated in order to allow retry of the failing SEND 
request. 


GENERATING THE SAMPLE NODE ERROR PROGRAM 


The routing mechanism, common subroutines, IBM-supplied error 
processors, and user-supplied error processors are generated by means of 
DFHSNEP macros. 

The sample node error program is added to the system in the same way 
as system tables. Refer to the appropriate CICS/VS System Programmer’s 
Guide for further details on assembling and link-editing CICS/VS system 
tables. When using the sample node error program, the CSNE TWA size 
must be increased by a minimum of 4 bytes. An extra 24 bytes are 
required for the common subroutines register save area, and further 
space is required for the error processor save area. The CICS/VS sample 
processors use 4 bytes of this area. 

The DFHSNEP macro to generate the sample node error program has four 
types, as follows: 

TYPE=INITIAL 

to generate the routing mechanism and, optionally, the common 
subroutines. 

TYPE=DEF3 27 0 

to generate the default IBM-supplied error processors for 3270 
devices. 

TYPE=DEFILU 

to generate the default IBM-supplied error processor for 
interactive logical units operating in contention mode. 

TYPE=FINAL 

to indicate the end of the sample node error program. 

The order of these macros is constrained so that there is one 
TYPE=INITIAL which appears first, and one TYPE=FINAL and which appears 
last. 
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Routing Mechanism — DFHSNEP TYPE=INITIAL 


The following operands can be used on the DFHSNEP TYPE=INITIAL macro 
instruction: 


r-r-r- 

j IDFHSNEP j TYPE=INITIAL 

j | | t,CS=NO] 

j j | [,NAME=name] 

j j j t,NETNAME=netname] 

L-L-I—- 


1 

I 

I 

I 

I 

.J 


TYPE=INITIAL 

indicates the start of the sample node error program and causes 
the routing mechanism to be generated. 


CS=NO 

specifies that the generation of the common subroutines is to 
be suppressed. This operand should not be specified if 
TYPE=DEF3270 is included. 


NAME=name 

specifies the name of the node error program module identifier. 
The name must be a string of one through eight characters. 

This operand is optional and defaults to DFHZNEP. If the 
interface module DFHZNEP (generated by the DFHZNEPI macro) is 
used, this operand must be specified (with a name other than 
DFHZNEP). 


NETNAME=netname 

specifies the name of the node error table that is to be loaded 
at initialization. The name must be a string of one through 
eight characters. This operand is optional and defaults to 
DFHNET. 


3270 Error Processors — DFHSNEP TYPE=DEF3270 


The DFHSNEP TYPE=DEF3270 macro has the following format: 

r- r - r - 

j jDFHSNEPj TYPE=DEF3270 

l-l-1- 



TYPE=DEF3 2 7 0 

specifies that the IBM-supplied error processors for 3270 
logical units are to be included in the node error program. 
This macro causes the following source code to be generated: 

DFHSNEP TYPE=ERRPROC,GROUP=l,CODE=(D9,DC f DD) 
sense/status error processor code 

DFHSNEP TYPE=ERRPROC,GROUP=2 , CODE=42 

unavailable printer error processor code 
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Error Processors for INTLU -- DFHSNEP TYPE=DEFILU 


The DFHSNEP TYPE=DEFILU macro has the following format: 


r-r-r- 

j |DFHSNEP| TYPE=DEFILU 

L-L-L_ 


n 

I 

J 


TYPE=DEFILU 

specifies that the IBM-supplied error processor for interactive 
logical units is to be included in the node error program. 

This macro causes the following source code to be generated: 

DFHSNEP TYPE=ERRPROC,GR0UP=1,CODE=DC 

receiver in transmit mode error processor code 


Terminate DFHSNEP Entries — DFHSNEP TYPE=FINAL 


The DFHSNEP TYPE=FINAL macro has the following format: 


r- r - r - 

| jDFHSNEPj TYPE= FINAL 

L-L- t _ 


*•1 

I 

J 


TYPE=FINAL 

indicates the end of the node error program and causes the 
error processor vector table (EPVT) to be generated. 


I Generate the Sample Node Error Table — DFHSNET 


The DFHSNET macro is used to generate a node error table. 


r 

— r — - — r - 
|DFHSNETj 

(NAME=name3 



i i 

i i 

[,COUNT=threshold] 



C # ESBS=(index,length,...)] 



i i 

C,NEBNAME=(name 



i i 

[ , NEBS=number3 



i i 

[ 9 TIME=(interval,units)3 



L-t-L_J 


NAME=name 

specifies the identifier to be included in the NET header. It 
must be a string of one through eight characters. This operand 
is optional and defaults to DFHSNET. 
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COUNT=threshold 

specifies the error count threshold that is to be stored in the 
NET header for use by the common subroutines to update standard 
ESBs. If the threshold is exceeded, the error processor that 
invoked the subroutine is informed by a return code. The 
maximum value is 32767. This operand is optional and defaults 
to 100. 


ESBS=(index,length,...) 

specifies the ESB structure for each NEB. This operand is 
coded as a sublist. Each element of the sublist comprises two 
values? "index” specifies an error group index for which an ESB 
is to be included in the NEB; "length" specifies the status 
area length, in bytes, for that ESB. The parentheses may be 
omitted for a single element, "index" must be specified as a 
two-character representation of a one-byte hexadecimal number 
in the range 01 through FF (a leading zero can be omitted). 
"length" is constrained only by the fact that an eight-byte NEB 
header plus a four-byte header for each ESB must be contained 
within the maximum NEB length of 32767 bytes. If a null value 
is specified, a standard ESB with a status area length of 6 
bytes is assumed. This is suitable for use by the common 
subroutines in maintaining a time-stamped error count. This 
operand is optional and defaults to 1. This causes each NEB to 
be generated with one ESB for error group 1 with a status area 
length of 6 bytes. 


NEBNAME= (name 

specifies the names of nodes that are to have a permanently- 
assigned NEB. The names specified are assigned, in the order 
specified, to the set of NEBs requested by the NEBS operand. 
Any remaining NEBs are available for dynamic allocation to 
other nodes as errors occur. "name" must be a string of one 
through four characters. The parentheses can be omitted for a 
single name. This operand is optional and has no default. 


NEBS=number 

specifies the number of NEBs required in the NET. The maximum 
valid number is 32767; the default is 10. 


TIME=(interval,units) 

specifies the time interval that is to be stored in the NET 
header for use by the common subroutines to maintain error 
counts in standard ESBs. If the threshold specified in the 
COUNT operand is not exceeded before this time interval elapses 
then the error count is reset to zero. "units" must be 
specified as SEC, MIN, or HRS. "interval" has the following 
maximum values: (86400,SEC), (1440,MIN), or (24,HRS). This 
operand is optional and defaults to (7,MIN). 

Note : The above described sample node error program, with a name other 

than DFHZNEP, can be used as a transaction-class routine for the 
interface module, DFHZNEPI. 


CICS/VS System Programmers Reference Manual 


368 



USER-WRITTEN NODE ERROR PROGRAMS 


| CICS/VS Version 1, Release 2 and subsequent releases differ from 
| previous releases in that they cater for the possibility that the use of 
logical units may demand different handling of the error, according to 
the kind of transaction being processed* The user of Version 1, Release 
2 and later releases can write a separate node error program for each 
class of transaction. When an error occurs, the node abnormal condition 
program passes control to an interface module, DFHZNEPI, which 
determines the transaction class and passes control to the appropriate 
node error program. 

If only one node error program is used, the interface module 
(DFHZNEP) is not required. If the node error program is named DFHZNEP, 
the node abnormal condition program will branch directly to that. If 
more than one node error program is used, the interface module 
(DFHZNEPI) is required. In this case, the node error programs must be 
given names other than DFHZNEP. Every node error program generated must 
be defined in the processing program table (PPT) by means of a DFHPPT 
TYPE=ENTRY macro instruction. 

The transaction-class oriented node abnormal condition program/node 
error program design is functionally compatible with the pre-Version 1, 
Release 2 node abnormal condition program/node error program interface. 
However, a pre-Version 1, Release 2 user-written node error program 
requires one of the following steps to be taken. 

1. Do not build a new node error program, but add to the existing 
user-written node error program as required. 

2. Nominate the existing node error program as the default user- 
written transaction-class routine by renaming the existing node 
error program to "username” and specifying the following DFHZNEPI 
macro instructions: 

DFHZNEPI TYPE=INITIAL, DEFAULT 22 "username" 

DFHZNEPI TYPE=ENTRY 

(Definitions for required user-written routines.) 

DFHZNEPI TYPE-FINAL 

In the event of there being existing transactions for which 
NEPCLAS=integer has not been specified in DFHPCT TYPE=ENTRY, any errors 
in these transactions will result in a link to the original node error 
program module, specified in DFHZNEPI TYPE=INITIAL as the default 
transaction-class routine. 


DFHZNEPI MACROS 


The following macros are required to generate the node error program 
interface module (DFHZNEPI): 

• DFHZNEPI TYPE=INITIAL - to specify the name of the default 
transaction-class routine 

• DFHZNEPI TYPE=ENTRY - to associate the transaction-class with the 
user-written transaction-class error handling routine 

• DFHZNEPI TYPE=FINAL - to end the DFHZNEPI macro instructions 
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The DFHZNEPI interface module must be generated when the system 
programmer requires the node abnormal condition program to pass control 
to the appropriate user-written node error program for resolution of the 
error. 


I Default Transaction-class Routine — DFHZNEPI TYPE=INITIAL 


The DFHZNEPI TYPE=INITIAL macro instruction specifies the name of the 
default transaction-class routine to be used for the DFNZNEPI module. 

r r ™ r *- 

I |DFHZNEPI| TYPE=INITIAL 

| | | t,DEFAULT=name] 

L-L-t- 


DEFAULT=name 

specifes the name of the default transaction-class routine to 
be used. A link will be made to this default routine under any 
one of three conditions: 

(1) Specification of DFHPCT TYPE=ENTRY,NEPCLAS=0 (default). 

(2) Specification of DFHPCT TYPE=ENTRY,NEPCLAS=value >255. 

(3) No transaction-class routine has been specified via the 
DFHZNEPI TYPE=ENTRY macro for the transaction-class value 
identified by the DFHPCT TYPE=ENTRY,NEPCLAS=integer 
specification. 

The DFHZNEPI TYPE=INITIAL instruction must always be specified, and 
must be before any of the other DFHZNEPI macro instruction forms. Only 
one TYPE=INITIAL macro may be specified. 


I 

I 

j 


Transaction-class Error-handling Routine 
TYPE=ENTRY 


DFHZNEPI 


The DFHZNEPI TYPE^ENTRY macro instruction is used to associate the 
transaction-class, specified in the NEPCLAS^integer operand of the 
DFHPCT TYPE=ENTRY instruction, with a user-written transaction-class 
error handling routine. The format of this macro instruction is as 
follows: 


| DFHZNEPI| TYPE=ENTRY 
j j ,NEPCLAS=integer 

| | ,NEPNAME=name 


NEPCLAS=integer 

specifies the transaction-class, and must be in the range 1 
through 255. 0 or a value greater than 255 must not be 

specified, nor should any value that has been specified in a 
previous DFHZNEPI TYPE=ENTRY instruction. 
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NE PNAME=n ame 

specifies a name for the transaction-class routine to be 
associated with the specified transaction-class* An error 
condition will result if "name" is specified either as DFHZNEP, 
or is greater than eight characters in length. 

Both the TYPE=ENTRY operands must be specified. 


Terminate Entries — DFHZNEPI TYPE=FINAL 


r r " r 

| jDFHZNEPIj TYPE=FINAL 

L-L-L- 


1 


J 


TYPE=FINAL 

completes the definition of module DFHZNEP and must be 
specified last. The assembly should be terminated by the 
statement: END DFHZNEPI. 


User-supplied Error Processors — DFHSNEP TYPE=ERRPROC 


The DFHSNEP TYPE=ERRPROC macro is used to indicate the start of a user- 
supplied error processor (the actual error processor code should 
immediately follow this macro). 

The following operands can be used on the DFHSNEP TYPE=ERRPROC macro 
instruction: 


r - r - r - 

j j DFHSNEP j TYPE=ERRPROC 

j | j ,CODE=(error-code,....) 

j | j ,GROUP=error-group-index 

t- l_l_ 


I 

I 


TYPE=ERRPROC 

indicates the start of a user-supplied error processor. 


CODE=(error-code,...) 

specifies the error codes that make up the error group and 
which are therefore handled by the error processor supplied. 

The operand is coded as a sublist of two-character 
representations of one-byte hexadecimal codes (the parentheses 
may be omitted for a single code). For each code specified the 
error group index is placed at the equivalent offset in the 
translate table and thus when this code occurs the appropriate 
error processor can be identified. 
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GROUP^error-group-index 

specifies an error group index for the error processor. This 
index is used to name the error processor, locate its address 
from the error processor vector table (EPVT), and optionally 
associate it with an ESB in each NEB. The index specified must 
be a two-character representation of a one-byte hexadecimal 
number in the range 01 through FF (a leading zero can be 
omitted). The error processor name has the form NEPROCxx, 
where "xx" is the error group index. A CSECT statement of this 
name is generated, which causes the error processor code to be 
assembled at the end of the node error program module and to 
have its own addressability. 


CICS/VS users who intend to add their own error processors to the 
sample node error program should be aware of the following conventions 
used by the sample node error program. 


Register Assignment 

Register 

0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 


Notes 2 


Use 

Work register 
NET base register 
NEB base register 
ESB base register 

Error count increment, also work register 
Work register 


TCTTE base register 

Sample node error program base register 
TCA base register 
CSA base register 

CSVT base and error processor link register 
Common subroutine link register 
Error processor branch register 
Common subroutine branch register 


1. Registers 12 and 13 must be preserved at all times. 

2. Register 14 must be saved for return from error processors. The 
CSVT is coded after the BALR to the error processor and so this 
register is also the CSVT base. 

3. In addition to registers 12, 13 and 14, registers 1, 10 and 15 are 
set up on entry to error processors. 

4. Registers 14-11 may be saved by error processors in an area 
reserved in the TWA at label TWAEPRS. Registers 15-11 do not need 
to be restored before return from error processors. 

5. Registers 4-9 may be saved by common subroutines in an area 
reserved in the TWA at label TWACSRS- They must be restored before 
return from the subroutines. 


DSECTS 

The following DSECTs are provided: 
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Node Error 

Table 

Header: 

This contains the table name and common 

information relevant for 

all the node error blocks (NEBs) in 

the 

table 

DFHNETH 

DSECT 





NETHNAM 

DS 

CL8 

table name 



NETHNBN 

DS 

H 

no. of NEBs in table 



NETHNBL 

DS 

H 

length of NEBs in table 



NETHTIM 

DS 

BL4 

error count time interval 



NETHECT 

DS 

H 

error count threshold 



NETHFLG 

DS 

X 

flag byte 



NETHINI 

EQU 

X 

© 

m 

table initialised 




DS 

X 

reserved 



NETHFNB 

DS 

OF 

first NEB 



Node Error 

Block: 

The table contains node error blocks that 

are 

used 

for recording error information for individual nodes. These 

may 

be 

permanently assigned to 

specific nodes or dynamically assigned at the 

request of 

error 

processors. 



DFHNETB 

DSECT 





NEBNAM 

DS 

CL4 

node name 



NEBFLG 

DS 

X 

flag byte 



NEBPERM 

EQU 

X'Ol* 

permanently assigned NEB 




DS 

XL3 

reserved 



NEBFESB 

DS 

OX 

first NEB 




Error Status Block ; The NEBs may contain error status blocks. These 
are reserved for specific error processors and are identified by the 
corresponding error group index. An ESB may have a user defined format 
or may have a standard format suitable for counting errors over a fixed 
time interval. 


DFHNETE 

DSECT 



ESBEGI 

DS 

X 

error group index 

ESBFLG 

DS 

X 

flag byte 

ESBSTAN 

EQU 

X’01 f 

standard format ESB 

ESBTTE 

EQU 

X* 02 * 

time threshold exceeded 

ESBCTE 

EQU 

X* 04* 

count threshold exceeded 

ESBSLEN 

DS 

XL2 

status area length 

ESBHLEN 

EQU 

♦-DFHNETE 

ESB header length 

ESBSTAT 

DS 

OX 

status area 


The following fields apply to the standard format: 

ESBTIM DS BL4 time stamp 

ESBEC DS XL2 error count 

Common Subroutine Vector Table : The CSVT provides error processors with 
addressability to the common subroutines. The error processor link 
register gives addressability to the CSVT and so the first portion of 
the DSECT overlays the code required to branch around the actual table. 


DFHNEPC 

DSECT 

DS 

F 

load instruction 


DS 

F 

branch instruction 

CSVTNEP 

DS 

A 

node error program base address 

CSVTESBL 

DS 

A 

NEPESBL - ESB locate routine 

CSVTNEBD 

DS 

A 

NEPNEBD - NEB delete routine 

CSVTECUP 

DS 

A 

NEPECUP - error count update routine 
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3270 UNAVAILABLE PRINTER 


This condition arises when a print request is made through the 3270 
print request facility and there are no printers on the control unit, or 
when the printer(s) is in one of the following conditions: 

• Out of service 

• Not in tranceive or receive status for automatic transaction 
initiation 

• A task is presently attached 

• Currently busy on a previous operation 

• Intervention required 

The procedure is applicable to 3270 logical units or the 3270 
compatibility mode logical unit when using the PRINTTO and ALTPRT 
operands of the DFHTCT TYPE=TERMINAL macro. 

The terminal control program recognizes this condition and issues a 
READ BUFFER operation to collect the data into a terminal I/O area. The 
TIOA is of the same format as when an application program has issued a 
terminal control read buffer request. 

The terminal control program VTAM portion (DFHZCP) then queues the 
TCTTE to the node abnormal condition program with the error code X f 42'* 
(TCZCUNPRT). The fields relevant to this situation are: 


TCTTEDA - Data address area 

TWAPRNT - Field for node error program to return information to the 
node abnormal condition program. 

Set to zero on initial entry to node error program 

The node abnormal condition program writes the DFH2497 UNAVAILABLE 
PRINTER message to the CSMT destination and links to the node error 
program with no default actions set. 

On return from node error program, the node abnormal condition 
program will perform the following actions, based upon the TWAPRNT in 
the TWA: 

1. If TWAPRNT is all FFs (-1), the node abnormal condition program 
assumes that node error program has disposed of the data to be 
printed. 

2. If TWAPRNT is zero, the node abnormal condition program assumes 
that no printer is available. 

3. If TWAPRNT is neither -1 or zero, the node abnormal condition 
program assumes that TWAPRNT is the address of the printer. An 
interval control PUT will be performed to the provided terminal. 

The transaction to be initiated is CSPP (print program), and the 
time interval will be zero. 
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a. If an error occurs on the interval control PUT, the node 
abnormal condition program will write the DFH2496 IC FAILURE 
message to the destination CSMT. The node abnormal condition 
program will then link to node error program again with the 
TWAPRNT field set to -2. This is done in order for node error 
program to have a last chance to dispose of the data. Upon the 
second return from node error program to the node abnormal 
condition program, the node abnormal condition program will 
reexamine TWAPRNT. If TWAPRNT is -1, this indicates that the 
node error program has disposed of the data. 

b. If no error occurred on the interval control PUT, the node 
abnormal condition program will check for the following printer 
conditions: 

Out of service 

Intervention required 

Other than RECEIVE or TRANSCEIVE status 

If one of these conditions is true, the node abnormal condition 
program will issue the DFH2495 PRINTER OUTSERV/IR/INELIGIBLE- 
REQ QUEUED message to the destination CSMT. 

4. The node abnormal condition program will then terminate any PRINT 
requests on the originating terminal and will perform normal action 
flag processing on that terminal. 
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Chapter 4.4. Transaction Abend 


| There are five places where user-written recovery logic may be executed 
in CICS/VSs 

• Task level abend exit 

• System abend exit 

• Program error program exit 

• Dynamic transaction backout abend exits 

| • The transaction restart facility 

Information about these exits and the differences between OS/VS and 
DOS/VS recovery appears in the following sections and is shown 
graphically in Figure 4*4* Information on system abend exits can be 
found in Chapter 4-5. 
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Application 

Program 


Normal 

Completion 


Abnormal 

Completion 


Program 

Check 


Other 

ABENDS 



EXTENDED DESCRIPTION 

CHART 

1 . 

DFHPC RETURN request issued by application program. 
Control passed to DFHPCP. 

A 

2. 

DFHPC ABEND request issued by application program 
or by CICS/VS. Control passed to DFHPCP. 

B 

3. 

Operating system detected a program interrupt. 

Control passed to DFHSRP. 

C 

4. 

Operating system detected an error. Control 
passed to DFHSRP. 

D 


transaction \ 
on highest logical 
s '\ level 


Terminate 

transaction 


Exit to program 
at next higher 
level 


Figure 4.4 (Part. 1 of 4). Termination and Recovery of CICS/VS 
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| Figure 4.4 (Part 2 of 4). Termination and Recovery of CICS/VS 
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| Figure 4.4 (Part 3 of 4). Termination and Recovery of CICS/VS 
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| Figure 4,4 (Part 4 of 4), Termination and Recovery of CICS/VS 


If the program error program (DFHPEP) is defined in the PPT, it will 
be executed every time a task is abnormally terminated. An exit routine 
established by a DFHPC TYPE=SETXIT macro instruction or by a DFHPC 
HANDLE ABEND command will be executed if a task abend is requested while 
the task is at the level at which the SETXIT was issued, or at a lower 
level. If the task continues to abend, DFHPEP will be entered if 
defined after return from the highest level, 

A recovery routine or program, defined in the SRT, will be executed 
if a task causes the system abend which corresponds to the SRT entry 
abend code. In CICS/VS, after this logic is executed, the task is 
abnormally terminated, and the task level abend exit(s) is (are) 
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executed followed by DFHPEP. However, it should be pointed out that as 
each succeeding exit is entered, the logic is further away from the 
cause of the abend, and the available information and corrective action 
possible are less. 


CREATING A TASK ABEND EXIT 


The DFHPC TYPE=SETXIT macro instruction and the HANDLE ABEND command 
allow the application programmer to specify the name of a program or a 
routine to be given control when a task completes abnormally. Exit 
programs can be coded in any supported language, but exit routines must 
be coded in the same language as the program of which they are a part. 

| For information on the transaction abend codes for abnormal 
j terminations that are initiated by CICS/VS, their meanings, and the 
j audience actions, refer to the CICS/VS Messages and Codes manual. 

Upon entry to an exit program, no addressability can be assumed other 
than what is normally assumed for any application program coded in that 
| language. If the exit logic is in the form of a routine (DFHPC 
| TYPE=SETXIT,ROUTINE=...), the amount of addressability varies depending 
j on the source language (for the macro interface) as follows: 


Assembler: 

Reg 12 

- 

TCA address 


13 

- 

CSA address 


14 

- 

Entry address for routine 


15-11 


Varies depending on cause and location of 
Abend 

COBOL: 

Reg 12 

- 

PGT address 


13 

- 

TGT address 


14 

- 

Entry address for routine 


15-11 


Contents at time of last CICS/VS service 
request 


For a routine, the register values in the command interface (HANDLE 
ABEND LABEL (...)) are: 


| Assembler: Reg 15 - Abend Label 

j 0-14 - Contents at the time of the 

| last CICS/VS service request. 

| COBOL: Control returns to the HANDLE ABEND 

j command with the registers restored; a 

j COBOL GO TO is then executed. 

| RPG II: (DOS/VS only) As for assembler. 

Note : For the DOS/VS ANS COBOL Subset, Register 12 will not contain the 

PGT address, but whatever it contained at the time of the last CICS/VS 
service request. 

Other information that is available to the exit routine or program 
includes: 

• The abnormal completion code at TCAPCAC 

• Any user-defined information which is placed in the TWA 
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• If the abnormal completion code is ASRA (that is, as a result of a 
program check), the PSW at the time of program interrupt is stored 
in field TCAPCPSW. 

There are three means of terminating processing in an exit routine or 
program: 

• DFHPC TYPE=RETURN or the RETURN command indicate that the task is 
to continue running with control passed to the program on the next 
higher logical level. If no such program exists, the task is 
terminated normally. 

• DFHPC TYPE=ABEND and the ABEND command indicate that the task is to 
be abnormally terminated with control passed either to an exit 
specified for a program on a higher logical level or to the 
abnormal condition program (DFHACP) for abnormal termination 
processing. Branch to some location to retry an operation. It is 
the user's responsibility to establish registers and code for the 
use of the exit logic. When this method is used and the original 
exit routine or program is to be entered if the retried operation 
fails again, the exit routine or program should issue the DFHPC 
TYPE=RESETXIT macro or the HANDLE ABEND RESET command prior to 
branching, because it will have been disabled by CICS/VS to prevent 
recursive entry into the exit. 

Note : If an abend occurs during the invocation of a CICS/VS service, 

the system programmer should be aware that issuing a further request for 
the same service may cause unpredictable results, because the 
reinitialization of pointers and work areas, and the freeing of storage 
areas in the exit routine, may not have been completed. 


PROGRAM ERROR PROGRAM (DFHPEP) 


The distributed version of DFHPEP contains code to establish a base 
register, to establish addressability to the system portion of the TCA, 
and to return control to DFHACP through a DFHPC RETURN operation. This 
module may be updated to include any user logic. 

Information available to DFHPEP includes: 

• The abend code at TCAPCAC 

• Whether the abend code is ASRA, and whether the PSW is at TCAPCPSW 

• The PCT entry address at TCATCPC 

• Any other data placed in the TWA by the application program or 
SETXIT routines 

If the PCT entry is to be disabled, a hexadecimal 01 should be placed in 
field TCAPECOM at the system portion of the TCA. For example: 

MVI TCAPECOM,TCAPEDIS SHOW PCT TO BE DISABLED 

Note : TCAPEDIS has been equated to X'01* in the TCA dummy section. 

Care should be taken not to disable CICS/VS transactions, a list of 
which is provided in Appendix A. 


Chapter 4.4. Transaction Abend 


383 




USER EXITS IN THE DYNAMIC TRANSACTION BACKQUT PROGRAM 


The dynamic transaction backout program (DFHDBP) has four user exits, 
which the system programmer may code if the default action does not suit 
his requirements. (The default corresponds to a return to 0(R14) in the 
following description.) The dynamic transaction backout exits are: 

1. XINIT. This exit is given control on entry to DFHDBP. The system 
programmer must code BR R14 to continue dynamic transaction 
backout, B 4(R14) if DL/I backout is not to be done, and B 8(R14) 
to continue the abend. 

2. XINPUT. This exit is given control when each log record (other 
than from DL/I) is obtained. Symbolic register DBRREG points to 
the record read from the dynamic log, and should be addressed using 
the DFHDBRDS DSECT. The system programmer must code B 0(R14) to 
continue processing this record, and B 4(R14) to ignore this 
record. (For the record corresponding to the input message, the B 

4(R14) return is not applicable.) 

3. XFERROR• This exit is given control when an error condition has 
been returned from the file control program during the backout 
processing or if an error has been detected by DFHDBP itself. 

Symbolic register DBRREG points to the record read from the dynamic 
log, and the record should be referenced using DFHDBRDS DSECT. 
Returns from this exit follow the convention that BR R14 means that 
the error continues, and an error message is to be transmitted, and 
that B 4(R14) indicates that the error situation has been salvaged, 
and that no error message is to be issued. 

The byte DBRERRCD in the log record is set for different types of 
error as follows: 

DBFEGU 

If an error response is returned from FCP while servicing a GET- 
UPDATE-request. DFHDBP has attempted to retrieve the existing copy 
of the record prior to backing it out. The file control CHECK 
macro in combination with the type of record pointed to by DBRREG 
("read-for-update" or "write-add") can be used in the exit to 
determine the specific problem. 

DBFELE 

If the FWA acquired from FCP is not large enough to receive the 
before-copy data picked up from the dynamic log to perform the 
backout. The symbolic register FWACBAR points to the FWA on entry 
to the exit. The file control CHECK macro is not applicable to 
this error. 

DBFEPU 

If an error response is returned from FCP while servicing a PUT- 
UPDATE- request. DFHDBP has attempted to replace the existing copy 
of the record on the file with the "before-copy" pointed to by 
DBRREG. The file control CHECK macro can be issued in the exit to 
determine the specific error. 

DBFEPN 

If an error response is returned from FCP while servicing a PUT- 
NEW-request. DFHDBP has attempted to add the "before-copy" of a 
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deleted VSAM-KSDS data set record. The file control CHECK macro 
can be issued in the exit to determine the specific error. 

DBFEWA 

If the record read from the restart data set is a WRITE-ADD, the 
record is also read in from the file through a GET-UPDATE. For 
ISAM, BDAM, and VSAM-ESDS data sets, no delete function exists. 

The user is given the opportunity to "mark" the existing record on 
the file as deleted according to application-dependent logic. The 
FWA version of the record should be marked. If the user wants the 
FWA version to be reapplied, return should be made through a B 
8(,R14) instruction. If the user does not want this, and does not 
want an error message transmitted, return should be made through a 
B 4(,R14) instruction. 

Symbolic register FWACBAR points to the FWA containing the existing 
record on the file. The file control CHECK macro is not applicable 
to the error. 

A BR R14 return gives an error message as usual. 

DBFEVD 

If an error response is returned from FCP while servicing a VSAM- 
DELETE request. DFHDBP has attempted to delete a new record added 
to a VSAM-KSDS data set. The file control CHECK macro can be 
issued in the exit to determine the specific error. 

4. XDERROR• When the DL/I backout routine detects an error, its error 
message is routed to CSMT and this exit is then given control. 
DBRREG points at the corresponding dynamic log record. The 
information in the TCA fields TCADLII and TCADLIPA is also 
available. The user error routine can select the default action, 
which is to suppress all further DL/I backout, by returning using 
BR R14. A return using B 4(Rl4) indicates that this record is to 
be ignored and processing is to continue as though it had not 
existed. 

User-written dynamic transaction backout exits must be quasi¬ 
reentrant, and the registers at the exits must have the following 
characteristics s 

• Registers 1, 4, 5, 7, 8, 9, and 15 are to be free for use in all 

the user exit routines without needing to be restored on return. 

• Register 0 CRO) and register 6 (FWACBAR) must be preserved across 

XFERROR (FWACBAR addresses the FWA containing the relevant file 
record). Registers 0 and 6 are free for other exits. 

• Registers 2 (DBLREG) and 3 (DBRREG) must be preserved across 

XINPUT, XFERROR and XDERROR. DBRREG addresses the current dynamic 
log entry. 

• Registers 10 (TCASBAR), 11 (DBPBASE), 12 (TCACBAR), 13 (CSA base), 
and 14 (return register) must be preserved across all the exits. 

Recoverable resources may be modified in user exits but the following 
should be noted: 

• Changes to recoverable transient data and temporary storage should 
be avoided in the XINIT exit because they will be backed out 
immediately. 
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• File control GET for updates should be properly released, either 
implicitly or explicitly, or else backout may be locked out. 

• The current DL/I PSB should be left scheduled; it should not be 
terminated. 

A dynamic log resides initially in a main storage buffer (the dynamic 
buffer, the size of which is specified in the DBUFSZ operand of DFHSIT)• 
There is one of these dynamic logs for each transaction (allocated as 
required) that uses dynamic transaction backout and which modifies a 
recoverable file, a DL/I record, or has an input message from a 
protected terminal. If this buffer fills, the contents are rewritten to 
CICS/VS temporary storage, and the buffer is initialized as empty. Any 
record or message that is too large to fit into the buffer is put 
directly into temporary storage and is referenced from the buffer. 

The temporary storage used is either main or auxiliary, as specified 
by the user in the DTB operand of DFHSG PROGRAM=JCP, and the 
identification used for the dynamic log is "ffDTBbnnn", where "ff" is a 
byte of value X'FF" and "nnn" is the transaction number. This 
identification should not be specified as recoverable in the temporary 
storage table (DFHTST). 

Note : Full details of the uses of the dynamic transaction backout 
program can be found in the CICS/VS Svstem/Aoplication Design Guide. 


| TRANSACTION RESTART 


The CICS/VS transaction restart facility (generated by specifying 
RESTART=YES in DFHPCT TYPE=ENTRY) allows individual transactions (that 
terminate abnormally and are subsequently backed out by the dynamic 
transaction backout facility) to be restarted automatically without the 
need for operator intervention. Transaction restart will, in such cases 
as a program isolation deadlock, function in a manner that is 
transparent to the terminal operator. 

When dynamic transaction backout and transaction restart are used for 
resources that have been defined as non-recoverable, the resource will 
not be backed out. Recoverable resources are backed out up to the 
beginning of the LUW that was current when the transaction abnormally 
terminated. If dynamic transaction backout itself fails, transaction 
restart will not be attempted. 

Dynamic transaction backout invokes certain criteria, including the 
transaction restart program DFHRTY, when a transaction abnormally 
terminates. If transaction restart is selected, code will be invoked to 
clean-up user storage areas; if restart is not selected, the abnormal 
condition program will be invoked. 

The distributed version of the program DFHRTY contains code to: 

• Establish a base register 

• Establish addressability to the system portion of the TCA 

• If restart is about to be attempted, send a message to CSMT 

• Return control to DFHDBP through a program control RETURN operation 

Flags that are available to DFHRTY are set in the TCA as follows: 
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| • Byte TCAZLUWT (status of the LUW) contains: 

| TCAZRRD (read since last sync point) 

| TCAZRWRT (write since task initiated) 

j TCAIOSK (sync point taken) 

| • Byte TCADBRTS contains: 

j TCADBTRD (transaction has previously been restarted) 

j TCADBTRP (restart to proceed - setable by DFHRTY 

j after default setting has been performed by DFHDBP) 

| • TCADBABC (original abend code) 


I DFHRTY may be updated to include any user-written logic- Dynamic 
| transaction backout will suppress restart (when the abend code is other 
j than that for program isolation or a sync point, or if terminal traffic 
| after initial input has occurred) unless user-written exit code (DFHRTY) 
| tells it to proceed by setting TCADBTRP. Otherwise when transaction 
| restart is used, all messages from dynamic transaction backout will be 
j suppressed, and the transaction will be restarted from the beginning, 

| with the following information available to it: 

I • The initial input TIOA (if any) 

I • The contents of the TCTUA and the command-level communications 
I area, as at the start of the task 

| • The TCADBTRD flag (via ASSIGN RESTART command) 
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Chapter 4.5. System Abend 


The system recovery program (described in Chapter 2.2) receives control 
during abend (abnormal termination ) situations. It can either attempt 
recovery or allow CICS/VS to be closed down by the system. It will 
attempt recovery if the abend code passed by the system matches one in 
an entry in the system recovery table (DFHSRT) described in Chapter 3.2 
of this manual. If the corresponding abend code is found, the recovery 
code associated with the SRT entry is given control. The transaction is 
subsequently abnormally terminated but CICS/VS continues to function. 
Users may code SRT entries and the associated recovery codes. The 
default system recovery table contains certain codes and a recovery 
routine. For further details, see the system recovery table (DFHSRT) 
macro description in Chapter 3.2. 


CREATING A SYSTEM OR USER ABEND EXIT 


The DFHSRT macro instruction allows the system programmer to specify 
logic to be executed following an operating system abend and prior to 
abnormal termination of the CICS/VS partition/region. When abnormal 
termination occurs, control is given by the operating system to the STAE 
(all releases of OS/VSl and release 1 of OS/VS2), the ESTAE (OS/VS2 
release 2 or later), or the STXIT AB (DOS/VS) exit routine in DFHSRP for 
processing of the abend. If CICS/VS finds an entry in the system 
recovery table which matches the abend code issued by the operating 
system, the user's logic is executed. This logic can be in either of 
two formats: 

• A separately compiled program with a corresponding entry in the PPT 
(PROGRAM=name) 

• A routine coded either inline with the SRT following the TYPE=FINAL 
specification, or separately compiled but link-edited with the SRT 
(ROUTINE^name) 

Several considerations apply to the coding of this logic: 

• In CICS/VS, when control is returned from the abend exit, the task 
in control at the time of the abend is abnormally terminated with 
an abend code of ASRB. If all task abnormal termination exits are 
to be canceled, the character "C should be placed at TCAPCARO of 
the abnormally terminating task's TCA prior to returning to CICS/VS 
through a DFHPC RETURN request for a program, and through a branch 
to register 14 for a routine. 

• The error recovery routines read the TCAPCARO field in the TCA of 
the abnormally terminating transaction to see if CICS/VS considers 
the task to be recoverable. 

The following characters are set by DOS/VS in TCAPCARO: 

"A" which indicates that recovery of the transaction is possible. 

"N" which indicates that CICS/VS cannot continue after the 
transaction, and will be shut down. 

"A" and "N" are set by CICS/DOS/VS for the user to examine and act 
upon. 
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The following characters may be inserted in TCAPCARO by the users 

"C" (for DOS/VS and OS/VS) which cancels the SETXIT, causes the 
transaction to abend, and allows CICS/VS to carry on running* 

M P" (for DOS/VS) which proceeds with the SETXIT code. The 
transaction is abended, the SETXIT code is activated, and CICS/VS 
will continue. 

CICS/OS/VS will carry on with normal processing if possible after a 
transaction terminates abnormally; the only user action possible is to 
set TCAPCARO to "C" to cancel the SETXIT. CICS/DOS/VS will always 
terminate (for reasons of compatibility with earlier releases) unless 
the user sets TCAPCARO to either "P" or "C". 

If any character other than "C" or "P" is inserted in TCAPCARO, 
CICS/VS will not recover after the abend. 

• In all situations, the reason for the abnormal termination is 

stored in the abnormally terminating task* s TCA at TCAATAC and may 
be interrogated by the recovery logic. The format varies by 
operating system. 


OS/VS DOS/VS 

OOxxxyyy OOOOOOzz 

where xxx is the OS/VS system abend code 

yyy is the hexadecimal representation of the user abend code 
zz is the DOS/VS system abend code 

For example: 

00B37000 is an OS/VS B37 abend. 

000001F5 is a user 501 abend. 

00000021 indicates that an invalid SVC (for DOS/VS) 
has been issued. 

• To terminate the recovery logic and return control to the system 
recovery program, the following must be considered. For PROGRAM=, 
a DFHPC RETURN request is required. For ROUTINE=, a BR 14, where 
register 14 contains the value it contained upon entry to the 
routine, is required. 

• If the recovery logic is in the form of code link-edited with the 
table (ROUTINE=), the registers must be saved on entry and restored 
on exit, because a branch interface exists with the system recovery 
program. 

On DOS/VS, OS/VS1, and OS/VS2 release 1, addressability may be 
assumed only for the CSA and TCA. This is the standard assumption for 
CICS/VS application logic. On OS/VS2 release 2 or later, addressability 
may also be assumed via register 1 to the system diagnostic work area 
(SDWA). The SDWA is passed by OS/VS2 to ESTAE exit routines and 
contains information about the abend condition. For a description of 
the SDWA see the OS/VS2 Debugging Handbook . For ROUTINE the entry 
address will be in register 15. 

User-written recovery programs/routines written for CICS/VS systems 
with STAE will work correctly without change on CICS/VS systems with 
ESTAE. The reverse is not true if the user code inspects the contents 
of the SDWA. To make such code work on STAE and ESTAE systems, register 
1 should be tested on entry. If it is zero, there is no SDWA to inspect 
(STAE systems). If it is non-zero, it contains the address of the SDWA, 
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which can be inspected (ESTAE systems). Note that register 1 will also 
be set to zero on ESTAE systems if OS/VS2 is unable to obtain space for 
an SDWA* 

Any exit routine appended by the user to DFHSRT source code should 
not contain copy statements for DFHCSADS , DFHTCADS , DFHFCTDS, DFHFWADS , 
or DFHDCTDS, nor should it redefine registers SRTRRBAR, FWACBAR, 
FCTDSBAR, DCTCBAR, and WORKREG. This is because all these areas already 
exist in the default recovery code generated by the DFHSRT TYPE=FINAL 
macro. 

This is incompatible (on DOS/VS only) with previous releases, so that 
reassembling old source code for DFHSRT may cause a large number of 
"duplicate definition" errors. 
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Chapter 4,6. Journal Management 


| This chapter contains information on the CICS/VS journal management 
| facility which is an important factor in the recovery and restart 
I process. The following topics are discussed: 

| • The journal control table, in which the system programmer may 

j specify the devices to be used for containing journal records, the 

j size of the journal buffers, and additional options which may be 

j used during journaling. 

| • Application programming within the journaling process; for example, 

j opening, closing and reading journal data sets. 

| • The layout and contents of journal records. 

| • Methods of reading journal data sets. The options are: offline, 

| during execution of CICS/VS, backward, and forward. 

| The information in this chapter should be read in conjunction with 
j the discussion on journaling in the appropriate CICS/VS Application 
I Programmers Reference Manual . 

Journal management enables the user to create and retrieve journals 
during the execution of CICS/VS. Journals are special purpose 
sequential data sets which reside on tape or direct-access storage, and 
are defined in the journal control table (JCT). 

This chapter includes information to assist in the generation of the 
journal control program and journal control tables and in the writing 
and reading of journal records. A knowledge of the information in the 
journal services section of the CICS/VS Application Programmers 
Reference Manual is assumed. The reader should also be familiar with 
the appropriate information in the CICS/VS System Programmers Guide . 

In particular, if journal control is used with CICS/DOS/VS, the 
asynchronous loader option must be specified in the UPSI job control 
statement (see the CICS/VS System Programmer*s Guide (DOS/VS)) and the 
DOS/VS supervisor must be generated with AP=YES. 

journals are written by journal tasks in two stages. Firstly, the 
user's application program must issue a DFHJC TYPE=WRITE instruction to 
write the records to the journal buffer, and secondly, the journal task 
must write the records from the buffer to the journal data set. One 
journal task is initiated by system initialization for each journal. 
These tasks are assigned a high priority and are normally terminated 
only at system termination time. A few heavily used journal tasks are 
likely to be more efficient than many lightly loaded tasks, because they 
occupy less main storage and would probably be paged out less 
frequently. 

| The user should specify the JTYPEID option of the journal control 
| output request to assign the journal type identifications so that they 
are unique for each application program and for each type of record. 

The identification and other information described later are written in 
the system prefix to each journal record. 

The system log is a journal which is used by CICS/VS modules and must 
be defined if any of the following features are used: 

• Automatic logging. 
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• Automatic journaling, if directed to the SYSTEM journal file, as 
defined in the FCT and PCT entries. 

• Emergency restart. 

User written application programs may write to the system log whether 
any of the CICS/VS modules are using it or not. 

Note: If a CICS/VS automatic logging or automatic journaling operation 

to the system log cannot be performed successfully, CICS/VS or the 
transaction which causes the failure will be abnormally terminated as 
appropriate. 


THE JOURNAL CONTROL TABLE 

This section considers some of the factors involved in creating a 
journal control table, including specifying devices and buffer size. 


JOURNAL DEVICES 


A journal may reside on tape or disk and may occupy either one or two 
tape drives or disk extents. This is specified through the JTYPE 
keyword of the DFHJCT TYPE=ENTRY macro instruction. The greater speed 
with which data can be written to tape should be considered in selecting 
the device to be used. This is especially significant when a disk drive 
contains other data sets which may be used concurrently with journaling 
or when the user specifies synchronous journal operations. Tape is also 
the better choice when journaled data is to be retained for a length of 
time. 

Journal tapes are normally rewound and unloaded at end-of-volume or 
when the journal is closed. If two tape drives are assigned to a 
journal, the device is automatically switched at end-of-volume. 

Journal extents on disk are reused when filled. If two extents are 
specified, the system switches back and forth between them- If 
J0UR0PT=PAUSE is specified through the DFHJCT TYPE=ENTRY macro 
instruction, an extent will not start to be reused until the console 
operator allows it. This protects the data until the operator verifies 
that it is no longer needed; he may wish to dump the data to tape or 
process it in some other way before it is destroyed. 

All disk extents for journal data sets must be preformatted as 
described in the appropriate CICS/VS System Programmer's Guide. When 
disk journal data sets are opened at system initialization time, the 
pointers are positioned so that output will continue immediately after 
the last record written to the journal. 


BUFFER SIZE 

Journal records are blocked variable-length records. CICS/VS writes a 
block label record as the first record of each block and adds a system 
prefix to each journal record written. (See the section "Format and 
Contents of Journal Records.") The buffer size is specified by the 
BUFSIZE operand of the DFHJCT TYPE=ENTRY macro instruction. 

The minimum buffer size is the sum of the following: 
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• 42 bytes for the block length field and the block label record 

• 30 bytes for the record length field and the system prefix 

• Sufficient space to satisfy the largest journal output request made 

| through the journal control request, including: 

The length of the user prefix (plus 2 bytes) if specified by the 
| PFXLGTH operand in the journal control output request. 

The length of the journal record as specified by the JCDLGTH 
| operand in the journal control output request. 

The maximum buffer size is 32767 for tape or the track capacity of 
the device for disk. 

Other factors which need to be considered in selecting buffer size 
include: 

• If DL/I logging is being done through CICS/VS journaling, the 
maximum buffer size that can be specified is 1024, because most 
DL/I utilities that process the log tape cannot accept blocks 
larger than 1024 bytes. 

• The volume of records to be written. 

• The lengths of the records. 

• The percentage of synchronous requests. (When a synchronous 
request is made, the record is moved to the output area and the 
block is written regardless of its length. Control is not returned 
to the program which issued the journal output request until the 
data is recorded on the journal device.) 

• The advantage of allowing space in the buffer for additional blocks 
to be built while asynchronous blocks are being written. 

The following statistics are gathered for each journal to assist in 
tuning: 

• The number of output requests made. 

• The number of blocks written. 

• The average length of blocks written. 

• The number of times the buffer was full and a block had to be 
written before the next record could be moved to the buffer, 

• The number of occurrences of buffer shift-up. 

Buffer shift-up is a technique used by journal control to maximize 
free space in a journal buffer. This allows a smaller buffer to be used 
without impacting response time. This technique results in shorter 
output blocks while adding a small processing overhead for buffer 
reorganization. Normally, records are added to a variable-length block 
until there is insufficient free space in the buffer for the record or 
until a block is forced out by a synchronous request. However, when 
using the buffer shift-up technique, the writing of a block may begin 
when the block is filled to the buffer shift-up value. 

For purpose of illustration, assume the following specifications and 
events: The buffer size is 1800 bytes, the buffer shift-up value is 
1200 and no synchronous output requests are made. Records are moved to 
the buffer until 1140 bytes are used. The next record for this journal 
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occupies 80 bytes, including its prefix- The record is moved to the 
buffer and a write operation is initiated for that block because the 
buffer shift-up value is reached. The next block is initiated by 
building its block label record beginning in the 1221st byte of the 
buffer- Control is then returned to the requesting program. This 
journal is able to add records to the next block until output event 
completion time for the previous block- At that time, the second record 
in the buffer is shifted-up, that is, it is moved so that it begins in 
the first byte of the buffer. If the buffer is filled before completion 
of the previous write event, the task will have to wait before shifting 
the buffer. 

The buffer shift-up value is specified by the BUFSUV operand of the 
DFHJCT TYPE=ENTRY macro instruction. The maximum value for this 
operand, and the default, is the value specified by the BUFSIZE operand. 
With the maximum specification, shift-up will never occur. If a user 
wants to use the shift-up technique, it is suggested that he initially 
specify a shift-up value in the range of 50 to 75 percent of the buffer 
size. The statistics described above should be considered for tuning 
aids. There is no minimum for the buffer shift-up value, but it is 
unlikely that the user would specify a value less than 50 percent of the 
buffer size unless his intent is to have a large buffer to prevent 
paging and yet write short journal blocks. However, there is no 
guarantee that all blocks will be short. 

| If asynchronous writes are being made to a journal file, and if one 
| block is being written because the block size value has reached the 
| value in BUFSUV, the next block will have records added to it until the 
| last SIO has completed. This could result in the next block containing 
I more records than are implied by the BUFSUV operand. 

Each journal task acquires space for a TCA, a JCA, and the specified 
buffer size at the time it is created during system initialization. The 
TCA has a TWA length of zero. The JCA is 128 bytes in length. The user 
should do the following to minimize the paging of these areas: 

• Specify CLASS=LONG for the journal task*s entry, transaction CSJC, 
in the program control table. 

• Calculate BUFSIZE such that the total area acquired for the task, 
TCA plus JCA plus BUFSIZE, equals, or is a multiple of, the VS page 
size for the user's system. 


ADDITIONAL JOURNAL OPTIONS 


The following options may be specified through the JOUROPT operand of 
the DFHJCT TYPE 22 ENTRY macro instruction. 

RETRY specifies that if an I/O error is detected on output, journal 
control is to close the current volume (tape reel or disk extent), 
switch volumes, and try to write the block on the alternate volume. If 
the retry also fails (or if RETRY is not specified) a permanent I/O 
error condition exists. 

CRUCIAL specifies that this journal is vital to the user's system and 
CICS/VS will abend when a permanent I/O error is detected. If CRUCIAL 
is not specified, the journal is closed and the journal task is 
terminated. The CRUCIAL option is always in effect at the time the 
journal is opened or volumes are switched. 
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INPUT specifies that the journal may be read during CICS/VS 
execution. An attempt to open a journal for input which does not have 
this option specified will return an invalid request indication. 

PAUSE requires operator action before the automatic switching of disk 
extents and the reuse of disk space. The DFH4507 message is sent to the 
console operator, who must respond YES before journaling will continue. 
If PAUSE is not specified, the DFH4508 message is sent and the disk 
extent is over-written without waiting for an operator response. 


APPLICATION PROGRAMMING 


Typically, the system programmer will write the application programs 
which open and close journal data sets, but the application programmer 
will code the macro instructions which place records in the data sets. 

This section describes the following variants of the journal control 
macro instruction: 

• DFHJC TYPE^OPEN, which opens a data set 

• DFHJC TYPE=CLOSE, which closes a journal data set 

• DFHJC TYPE-GETB or TYPE=GETF, which reads records from a journal 
data set 

The program which issues these macro instructions must include the 
symbol JCABAR and a COPY DFHJCADS statement to include and address the 
journal control area (JCA). 

The JCA and the DFHJC macro instructions used to place records in a 
journal data set are described in the CICS/VS Application Programmer's 
Reference Manual (Macro Level) . The JOURNAL command, which can be used 
in ANS COBOL and PL/I programs to place records in a journal data set, 
is described in the CICS/VS Application Programmer's Reference Manual 
(Command Level). 


| OPENING A JOURNAL DATA SET — DFHJC TYPE=OPEN 


The general format of the DFHJC macro instruction to open journal data 
sets is described below. 



1 

DFHJC | TYPE=(OPEN,CINPUT|OUTPUT}) 



1 

j [,IDERROR=symbolic-address] 



1 

| [,INVREQ=symbolic-address] 



1 

| t,IOERROR=symbolic-addressl 



1 

1 [.JFILEID=CSYSTEMInnlYES>] 



1 

| l,NORESP=symbolic-address] 



1 

j t,SIVOL=YES] 



1 

j [,STATERR-symbolic-address] 



1 

j [,VOLERR=symbolic-address] 



1 

| t,VOLUME={NEXT|PREVIOUS|CURRENT|FIRST}] 



L_ 


TYPE=OPEN 

indicates that the specified journal file is to be opened. 
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OPEN,INPUT 

indicates that the specified journal volume is to be opened 
for input. 

OPEN,OUTPUT 

indicates that the specified journal volume is to be opened 
for output* Exclusive control of the journal is 
relinquished. 


IDERROR=symbolic-address 

specifies the address to which control is passed if the 
specified journal does not exist in the journal control table 
(JCT). 


INVREQ=symbolic-address 

specifies the address to which control is passed if the TYPE of 
request is invalid. Note that journals to be open for input 
must be specified with JOUROPT-INPUT in the JCT. 


IOERROR= symbolic-address 

specifies the address to which control is passed if the 
operating system open fails. 


JFILEID=SYSTEM|nn|YES 

specifies the identification of the journal to be opened. The 
default is JFILEID=SYSTEM. 

SYSTEM 

indicates that the journal is the system log data set. 


nn 

is a decimal value from 2 to 99 which identifies the 
journal. 

YES 

indicates that the journal identification has been 
previously loaded in the journal control area field 
JCAJFID. 


NORESP=symbolic-address 

specifies the address to which control is passed if the 
requested operation is successful. 


SIVOL—YES 

indicates, for TYPE=(OPEN,INPUT) requests, that a specific 
volume is required. The VOLUME keyword must also be present to 
specify positioning? however, VOLUME=CURRENT is invalid because 
SIVOL identifies a specific volume. 
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Note s SIVOL=YES is an invalid request for disk journals, 
because all disk journal extents must be permanently mounted* 
Before issuing a DFHJC macro instruction with SIVOL=YES, the 
user must load the journal control area fields JCARST (run 
start time), JCTVCD (volume creation date), and JCVSN (volume 
sequence number)* These three fields pass the volume- 
identification data to journal control. See "Layout and 
Contents of Journal Records" for the format of these fields. 
The data to be placed in these fields can be obtained by 
issuing a DFHJC TYPE=NOTE request. See "Reading Journal Data 
Sets." 


STATERR=symbolic-address 

specifies the address to which control is passed if the current 
status of the journal precludes the requested operation,. For 
example, the request is to OPEN a journal which is already 
open. A status error code is also returned if the request 
attempts to open a journal already under exclusive control of a 
different task. 


VOLERR=symbolic-address 

specifies the address to which control is passed if an OPEN 
request volume error occurs. The requested volume either does 
not exist or cannot be located. 


VOLUME= NEXT|PREVIOUS I CURRENT!FIRST 

specifies which volume of the journal data set is required, and 
how that volume is to be positioned when opened. The default 
is VOLUME=NEXT. NEXT and PREVIOUS refer to the time sequence 
in which the tapes are written. Tape volume label data is 
associated with output reels, in this chronological sequence: 
volume sequence number within volume creation date within run 
date. It is the operator's responsibility to ensure that tape 
journal volumes are kept and mounted in sequence. Disk journal 
volumes (extents) are permanently mounted, and journal control 
performs any necessary volume switch or positioning. 

NEXT 

For TYPE=(OPEN,OUTPUT) requests, journal output is to be 
continued from the start of the next reel or extent. For 
tape, a new scratch reel must be mounted. For disk, reuse 
of an extent will take place. VOLUME^NEXT is not possible 
if the journal was previously in input mode. VOLUME=NEXT 
will be ignored and VOLUME=CURRENT will be forced. 

For TYPE=(OPEN,INPUT) requests, the next volume in 
chronological sequence is to be mounted, if necessary, 
opened for input, and positioned at the start of the data 
set. 

PREVIOUS 

For TYPE=(OPEN,INPUT) requests, the previous volume in 
chronological sequence is to be mounted, if necessary, and 
opened for input positioned at the end of the data set. 
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CURRENT 

For TYPE=(OPEN,INPUT) requests, the current output volume 
(that is, the tape reel or disk extent which most recently 
received output) is to be opened for input and positioned 
at the end of data on the volume. 

Note : If the current tape output reel was closed with 
LEAVE=YES, no remounting or repositioning delay will occur. 

For TYPE=(OPEN,OUTPUT) requests, the current output volume 
is to be opened for output. For tape journals, this 
request is treated the same as VOLUME=NEXT, that is, a new 
output volume is begun. For disk, the journal is 
repositioned so that output continues after the last record 
previously written. 

FIRST 

For use only if OPEN=DEFERRED is specified in the DFHJCT 
TYPE=ENTRY macro. 

Note : During system initialization, all data sets included in 

the journal control table are opened with TYPE=(OPEN,OUTPUT), 
VOLUME=FIRST (unless OPEN=DEFERRED was specified). 

VOLUME=FIRST has the same effect as VOLUME=CURRENT, except that 
the sequence number for this first volume of each data set is 
initialized at 001. 

Note : VOLERR, STATERR, IDERROR, INVREQ, IOERROR and NORESP may be 

specified in a separate DFHJC TYPE=CHECK macro. 


| CLOSING A JOURNAL DATA SET — DFHJC TYPE=CLOSE 


The general format of the DFHJC macro instruction used to close a 
journal data set is described below. 



1 

DFHJC j 

1 

TYPE=CLOSE 



1 

1 

1 

[,IDERR0R=symbolic-address3 
(,IOERROR=symbolic-address] 

(.JFILEID={SYSTEM 1nn1YES>] 


1 

1 


1 

1 

1 

1 

( ,LEAVE={NO j YES}3 
(,NORESP=symbolic-address] 



1 

1 

t,STATERR=symbolic-address] 



TYPE=CLOSE 

indicates that the specified journal file is to be closed. 
Exclusive control of the journal file is given to the 
requesting task. 


IDERROR=symbolic-addres s 

specifies the address to which control is to be passed if an 
entry for the specified journal file does not exist in the 
journal control table. 


IOERROR=symbolic address 

specifies the address to which control is to be passed if an 
I/O error occurs. 
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JFILEID =SYSTEM |nn|YES 

specifies the identification of the journal to be closed. The 
default is JFILEID=SYSTEM. 

SYSTEM 

indicates that the journal is the system log data set. 


nn 

is a decimal value from 2 to 99 which identifies the 
journal. 


YES 

indicates that the journal identification has been 
previously loaded in the journal control area field 
JCAJFID. 


LEAVE=NO|YES 

indicates the positioning for tape journal files. The default 
is LEAVE=NO. The LEAVE keyword is ignored for disk files. 

YES 

indicates that the reel is to remain ready and mounted, 
positioned at the end of the file. 


NO 

* indicates that the reel is to be rewound and unloaded. 


NORESP=symbolic-address 

specifies the address to which control is to be passed if the 
requested operation is successful. 


STATERR=symbolic-address 

specifies the address to which control is passed if the current 
status of the journal precludes the requested operation; for 
example, if the request is to CLOSE an already closed journal. 

A status error code is also returned if the request attempts to 
close a journal already under exclusive control of a different 
task. 


| READING JOURNAL DATA SETS — DFHJC TYPE=GET 


The general format of the DFHJC macro instruction used to read journal 
data sets is described below. 

The system acquires an input area into which the journal record is 
moved. The address of this area is returned in the field JCAADATA. The 
user must use this address to establish addressability to the area, 
which is defined by the DFHJCRDS DSECT. See "Layout and Contents of 
Journal Records" which follows. 
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r — -r- r ----—1 

| | DFHJC j TYPE={GETB|GETF|NOTE|POINT} | 

| | | t,EOFADDR=symbolic-address] | 

| | j [,IDERROR=symbolic-address] j 

j j | [,INVREQ=symbolic-address3 | 

| j j [,IOERROR-symbolic-address] j 

j | j [ ,JFILEID={ SYSTEM Inni YES> 3 | 

| | | t,NORESP=symbolic-address] | 

j| j [,NOTOPEN=symbolic-address] | 

| | | [,STATERR=symbolic-address] | 

| | | C ,VOLERR=symbolic-address] j 

L—___t___l_._._,_-_J 


TYPE=GETBj GETF|NOTE|POINT 

indicates the journal operation required. 

GETB 

retrieve the journal record preceding the one last 
retrieved. 

GETF 

retrieve the next journal record. 

For TYPE=GETB and TYPE=GETF requests, the address of the 
journal record is returned in the journal control area at 
JCAADATA. The journal record is in CICS/VS transaction storage 
chained off the TCA of the calling program. 

Note : If a direction change occurs, for example, if a GETF 

follows a GETB, the same journal record will be retrieved. 

NOTE 

obtain positioning information for the currently open 
volume of the specified journal. Positioning data is 
returned in the journal control area field JCANOTE, and is 
accurate to logical record within block within volume. 
Positioning data includes the volume identification (fields 
JCARST, JCAVCD, and JCAVSN) needed for DFHJC 
TYPE=(OPEN,INPUT) requests which specify SIVOL=YES. 

Note : Positioning data for a journal open for input is 

returned for DFHJC TYPE-NOTE requests; at least one 
successful GETB or GETF request must precede the NOTE 
request. Positioning data for a journal open for output is 
obtained by including the NOTE keyword in the output 
request: for example, DFHJC TYPE=(PUT,NOTE). 

POINT 

reposition the currently open input volume to a specified 
logical record. Before issuing this request, the user must 
load the journal control area field JCANOTE with 
positioning data returned by a previous NOTE request. 
Following a successful POINT request, the logical journal 
record in question may be retrieved by a GETF request. 

Note : The correct volume of the journal must be currently 
open for input and at least one successful GETB or GETF 
request issued to it, preceding the POINT request. 
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EOFADDR= s ymbolic-addres s 

indicates the address to which control is to be passed if the 
journal reaches end-of-file for GETF, GETB or (tape only) POINT 
requests. 

Note ; After end-of-file is passed for a tape journal in the 
forward direction (GETF request), further attempts to retrieve 
from or reposition the volume will lead to unpredictable 
results and I/O errors. 


IDERROR=symbolic-address 

indicates the address to which control is to be passed if the 
specified journal does not exist in the journal control table. 


INVREQ= symbolie-address 

indicates the address to which control is to be passed if the 
TYPE of operation is invalid or specifies POINT or NOTE before 
any reads (GETF or GETB) from the current input volume. 


IOERROR=symbolic-address 

indicates the address to which control is to be passed if an 
I/O error occurs 


JFILEID=SYSTEM|nn|YES 

specifies the identification of the journal data set referenced 
in this operation. The default is JFILEID=SYSTEM. 

SYSTEM 

specifies the system log data set. 


nn 

is a decimal value from 2 to 99 which identifies the 
journal. 

YES 

indicates that the journal identification has been loaded 
into the JCAJFID field in the journal control area prior to 
issuing the request. 


NORESP=symbolic-address 

indicates the address to which control is to be passed if the 
requested operation is successful. 


NOTOPEN=symbolic-address 

indicates the address to which control is to be passed if the 
journal is not open. 


STATERR=symbolic-address 

indicates the address to which control is to be passed if the 
journal is open for output, or that the requesting task is not 
the one with exclusive control. 


VOLERR=symbolic-address 

indicates the address to which control is to be passed if a 
POINT request specifies a volume other than the one currently 
open for input. 
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Note : EOFADDR, STATERR, NOTOPEN, VOLERR, IDERROR, INVREQ, 10ERROR r and 
| NORESP keywords may be specified in separate DFHJC TYPE=CHECK macros or 
I HANDLE CONDITION requests. 


LAYOUT AND CONTENTS OF JOURNAL RECORDS 


Journal data sets are specified as undefined record type, but are 
formatted by the journal control program to correspond to the format of 
variable-length blocked records. That is, each block and each record 
within the block begin with an LLbb length field. Each block contains 
at least two logical records, because journal control creates a label 
record as the first record in every block. 

When retrieved directly from a journal by DFHJC TYPE=GETB or GETF 
requests, journal records are returned in a CICS/VS transaction storage 
area pointed to by field JCAADATA and are mapped by the DFHJCRDS DSECT. 

The first ten bytes of every journal record, including "label" 
records, consist of these fields: 


Field name in 

Field size 



DFHJCRDS DSECT 

in bytes 

Format 

Contents 

JCRBA 

EQU 

* 

Label for start of 
journal records. 

JCRLL 

2 

Halfword binary 

Length of record 

JCRBB 

2 

Binary Zeros 

Not used 

JCRSTRID 

2 

Hexadecimal 

System type-ID 

JCRUTRID 

2 

Hexadecimal 

User type-ID 

JCRLRN 

2 

Packed decimal 

Record number 
within block 


The system and user type-ID fields, JCRSTRID and JCRUTRID, are the 
means of distinguishing journal records output by CICS/VS, by such 
features as automatic journaling, from those output by direct user 
requests. 

For user journal requests , byte 1 of the system type-ID field always 
contains binary zeros; the user type-id field contains the two-byte 
hexadecimal code specified by the JTYPEID keyword of the output request. 

For CICS/VS journal requests , the user type-id is zero, and the 
system type-id consists of a 1-byte function code followed by a 1-byte 
module code. Valid settings of these codes are consolidated into the 
member DFHFMIDS of the CICS/VS assembler-language macro library as shown 
in Figure 4.6 below. 
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* - . - * 

* * * FUNCTION AND MODULE IDENTIFIERS * * * 

* * * (SEE FOLLOWING DSECTS: DFHDWEDS,DFHJCADS,DFHJCR * * * 

*_ - * 

* FUNCTION IDENTIFIERS 

* ____* 

* X"01* THRU X *7F * ARE RESERVED 

* X'" 20" PLUS X* 8 -' ...USE FOR AUTOMATIC JOURNALING 

* X" 40" PLUS X" 8—'* ...USE FOR AUTOMATIC LOGGING 

* X'F-" COMPOSIDE CODE RESERVED FOR SYNC-POINT LOGGING 

* (MUST BE PRESENT IN "LOGGABLE' DWE'S) 

* * JOURNAL CONTROL * * 

* - * 

FIDJCLAB EQU X"80" ... JOURNAL CONTROL LABEL RECORD 

* - . - * 

* * FILE CONTROL * * 

* _ * 

FIDALOG EQU X*40* ... AUTOMATICALLY LOGGED 

FIDAJRN EQU X"20" ... AUTOMATICALLY JOURNALED 

* PLUS ONE OF ... 

FIDFCRO EQU X* 80'* ... FILE CONTROL READ-ONLY 

FIDFCRU EQU X"81* ... FILE CONTROL READ-UPDATE 

FIDFCWU EQU X"82" ... FILE CONTROL WRITE-UPDATE 

FIDFCWA EQU X'83* ... FILE CONTROL WRITE-ADD 

* * TRANSIENT DATA * * 

* - * 

FIDTDIT EQU X’Fl* TD-DEST’S INPUT TASK 

FIDTDOT EQU X*F2* TD-DEST"S OUTPUT TASK 

FIDTDDP EQU X" F4" TD-DEST HAS DEFERRED PURGE 

FIDTDPLP EQU X'81* TD PHYSICAL 'FIRST PUT* LOG 

FIDTDPGT EQU X"82" TD PHYSICAL 'GET* LOG 

FIDTDPRL EQU X"83" TD PHYSICAL QUEUE ZERO LOG 

FIDTDPLG EQU X'84* TD PHYSICAL 'PURGE'* LOG 

* -.--- * 

* * TEMPORARY STORAGE FUNCTION IDENTIFIERS * * 

* _______ * 

FIDTSAL EQU X*40* AUTOMATIC LOGGING MASK 

FIDTSUPD EQU X"80" ..TEMP STRG UPDATE 

* 

FIDTSPRI EQU X'*F2* ..TEMP STRG PURGE/RELEASE 

FIDTSPUT EQU X"F4'* ..TEMP STRG PUT/PUTQ 

* * ACTIVITY KEYPOINT * * 

* ___* 

FIDAKS EQU X*80* ACTIVITY KEYPOINT START 

FIDAKE EQU X'81" ACTIVITY KEYPOINT END 

FIDKPTCA EQU X"82" ACTIVITY KP OF TCA 

FIDKPDCT EQU X'83" ACTIVITY KP OF DCT 

FIDKPTCR EQU X'*84" ACTIV.KP OF "WAIT FOR RESP. * 

* ___ . _ * 

* * SYNC POINT * * 

FIDLSOSP EQU X"Fl* LOGICAL START OF SYNC POINT 

FIDLEOTK EQU X"F2" LOGICAL END-OF-TASK 

FIDPEOTK EQU X"F3" PHYSICAL END-OF-TASK 

EQU X"F5" SYNC POINT REQUEST 

* ___._ * 

Figure 4.6 (Part 1 of 2). Journal Function and Module Identifications 
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* - — ------- * 

* * BMS FUNCTION IDENTIFIERS * * 

* ---- * 

FIDBMPM EQU X*81* ... BMS PARTIAL MESSAGE ON 

* TEMPORARY STORAGE 

* -4c 


* * TERMINAL CONTROL * * 


♦ 

FIDTCML 

EQU 

X* F0 * 

SYNC. PT-LOG SEQ. NUMBERS. . . 

* 



. THE 

ABOVE PLUS ANY OF FOLLOW'G 2... 

FIDTCDWL 

EQU 

X'01' 

... 

DEFRD.WRITE DATA 

FIDTCFMH 

EQU 

X' 02' 

— 

+ FMH 

FIDTCAL 

EQU 

X* 40 * 

AUTOMATIC LOGGING MASK.,.. 

FIDTCAJ 

EQU 

X* 20’ 

AUTOMATIC JOURNALING MASK... 

♦ 


. . 

. THE 

ABOVE 2 PLUS 1 OF FOLLOW'G 9... 

FIDTCTL 

EQU 

X' 80' 

... 

SEQ.NR. ONLY (L ONLY) 

FIDTCIM 

EQU 

X' 81' 

• • • 

INPUT MESSAGE CL AND J) 

FIDTCOM 

EQU 

X' 82' 

• • • 

OUTPUT MESSAGE (J ONLY) 

FIDTCWP 

EQU 

X'83' 

• • • 

WRITE WAS PURGED (L ONLY) 

FIDTCPPR 

EQU 

X* 84' 


POS.RESP.REC'D (L ONLY) 

FIDTCIMF 

EQU 

X' 85* 

• • • 

INPUT MSG (W/FMH) (L AND J) 

FIDTCOMN 

EQU 

X* 86 * 

• • • 

OUTP MSG (W/O FMH) (J ONL) 

FIDTCON 

EQU 

X' 87' 

• • • 

OUTP MSG, FMH, CCOMPL=NO 

FIDTCONN 

4c 

EQU 

X' 88* 

• • • 

OUTP MSG, W/O FMH, CCOMPL=NO 

* * 

4c -- — 


MODULE 

IDENTIFIERS: * 



MUST CONFORM 

TO STANDARD MESSAGE CODES 



MAY BE 

X" 01’ 

—>X'FF* 

MODIDKC 

EQU 

X' 03' 

m m m 

TASK CONTROL 

MODIDPC 

EQU 

X' 04* 

m m m 

PROGRAM CONTROL 

MODIDSC 

EQU 

X* 05' 

m • m 

STORAGE CONTROL 

MODIDDC 

EQU 

X' 07 * 

m m m 

DUMP CONTROL 

MODIDIC 

EQU 

X* 08' 

m m m 

INTERVAL CONTROL , 

MODIDTC 

EQU 

X'10' 

• m m 

TERMINAL CONTROL 

MODIDFC 

EQU 

X'll* 

mm* 

FILE CONTROL 

MODIDTD 

EQU 

X' 12' 

mm* 

TRANSIENT DATA 

MODIDTS 

EQU 

X* 13' 

• mm 

TEMPORARY STORAGE 

MODIDDL 

EQU 

X* 39' 

• mm 

DL/I INTERFACE 

MODIDBM 

EQU 

X' 40' 


BASIC MAPPING 

MODIDJC 

EQU 

X* 45' 

m m m 

JOURNAL CONTROL 

MODIDKPP 

EQU 

X* 54 * 

m m m 

KEYPOINT PROGRAM 

MODIDBI 

EQU 

X* 55' 

• mm 

BUILT-IN FUNCTIONS 

MODIDAKP 

EQU 

X' 58' 

m m m 

ACTIVITY KEYPOINT PROGRAM 

MODIDSPP 

EQU 

X* 59* 

m m m 

SYNC-POINT PROGRAM 

MODIDUSR 

4c -- 

EQU 

X'FF' 

RESVD.FOR USER SYNC-PT.SUPRT 


Figure 4.6 (Part 2 of 2). Journal Function and Module Identifications 

After the above common fields, journal records follow one of two 
formats. 

The first format applies only to the first record of every block. 
These are journal management's "label" records, which continue thus: 
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Field name in 
DFHJCRDS DSECT 

Field size 
in bytes 

Format 

Contents 

JCLRJFID 

1 

Binary 

Journal id 
(X'Ol* - X B 99 - > 

JCLRBLKN 

3 

Packed decimal 

Block number (1-n) 

JCLRVCD 

4 

Packed decimal 

Volume creation 
date (ooyyddd+) 

JCLRVSN 

2 

Packed decimal 

Volume sequence 
number (nnn+) 

JCLRLBW 

4 

Binary (disk) 

Relative TTR of 
previous block 

JCLRTBAL 

2 

Binary (disk) 

Track-balance from 
previous block 

JCLRTIME 

4 

Packed decimal 

Time block written 
(hhmmsss*) 

JCLRRST 

4 

Packed decimal 

Run start time 
(hhmmsss+) 

JCLRDATE 

4 

Packed decimal 

Date block written 
(ooyyddd+) 

All other journal records, which are created in response to external 
requests (DFHJC macro instructions), are continued with from one to 
three variable-length segments, in this order: 

• System prefix 



• User prefix (if any) 



• Journaled 

data 



System prefix: Every journal record includes a system prefix which is 
variable in length. The system prefix serves to identify the origin of 
the record and contains at least the following data: 

Field name in 
DFHJCRDS DSECT 

Field size 
in bytes 

Format 

Contents 

JCSPBA 

EQU 

♦ 

Label for system 
prefix begin address 

JCSPLL 

2 

Halfword binary 

Length of system 
prefix 

JCSPFS 

3 

Binary 

Flags 

Note: The first two bytes are reserved for future expansion. 

The third byte is field JCSPF1. The settings are: 
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JCSPUP 

JCSPSOTK 

JCSPLSTK 

JCSPRRIF 

JCSPMIDT 

EQU 

EQU 

EQU 

EQU 

EQU 

X' 01* 
X'* 02 

X* 04 * 
X* 08 * 
X*10* 

... User prefix present in record 
... Physical start-of-task 
... Logical start-of-task 
... DFHRUP record in-flight flag 
... Output message in doubt 

JCSPTASK 


3 

Packed decimal 

Task number as in 
TCAKCTTA 

JCSPTIME 


4 

Packed decimal 

Time of request 
(hhmmsss+) 

JCSPTRAN 


4 

Characters 

Transaction ident 
(or binary zeros) 

JCSPTERM 


4 

Characters 

Terminal 

identification 

JCSPREA 

EQU 

* 

Label for end of 
system prefix 
common root 


System prefix additional data ; For some CICS/VS journal requests, 
additional data is included in the system prefix to further identify the 
originator of the request. This additional data follows the above 
common fields and is usually variable in length? hence the need for the 
length-field JCSPLL at the start of the system prefix. 

For journal records created by the CICS/VS file control program*s 
automatic journaling or automatic logging features, the additional data 
in the system prefix is: 


Field name in Field size 

DFHJCRDS DSECT in bytes Format Contents 

JCSPFCFI 8 Character File id 

JCSPFCRI EQU * Start location label 

for record ident. 

(None) 1 to 255 Record identification 

Note that the DSECT does not provide a label for the record 
identification field itself since the user determines its length by the 
use of a DS field definition statement following the COPY DFHJCRDS 
statement. 

For journal records created by the CICS/VS terminal control program's 
automatic journaling or automatic logging features, the additional data 
in the system prefix is: 


Name 

Bytes 

Format 

Contents 

JCSPTCVS 

4 

2 halfwords 

VTAM*s sequence numbers 
(2 bytes inbound followed 
by 2 bytes outbound) 

JCSPTCL 

EQU 

* 

Label for end of terminal 
control's prefix 


J For journal records created by the sync point program during 
| intersystem communication sync point processing, the additional data in 
| the system prefix is: 
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Name 

Bytes Format 

Contents 

ORG JCASPREA 
JCAISSQI 2 

1 

halfword 

Sequence number of last 
inbound sync point request 

JCAISSQO 

2 

1 

halfword 

Sequence number of last 
outbound sync point request 

JCAISFL 

1 

1 

byte 

Flag 

JCAINDT 

EQU 

X* 80* 


* In-doubt* 

JCASSPR 

EQU 

X - 40* 


Sync point request sent 

JCAISAB 

EQU 

X* 20* 


Successful abort 

JCANDTB 

EQU 

X*10* 


No DTB if * in-doubt* 

JCAIFAIL 

EQU 

X* 08 ' 


Session failed 

JCAISOP 

DS CL3 


Operator id 

JCAISTM 

DS CL4 


Intersystem terminal id 

JCAISSPL 

EQU 

♦-JCASPBA 

Intersystem communication 


system prefix length 


User-prefix : The user prefix is optional, and is placed in a journal 

output record next to the system prefix, in response to the PFXADDR and 
| PFXLGTH keywords of the journal control output request. As with the 
system prefix, the user prefix always begins with a halfword binary 
length field; the data indicated by the PFXADDR keyword follows. For 
journal records which include a user prefix, the flag byte JCSPF1 of the 
system prefix has the indicator bit JCSPUP set to one. 

Journaled data : The final segment of journal records is the main data, 

| as specified by keywords JCDADDR and JCDLGTH of the journal control 
j output request. No length field should be included with the data 

because a length field is added immediately in front of the data area by 
journal control. The length of the data portion of a journal record can 
be computed by subtracting from the length of the journal record CJCRLL) 
the length of the record prefix (10 bytes) and the length of the system 
prefix (JCSPLL) and the length of the user prefix (in the field, if any, 
defined by the user). 


READING JOURNAL DATA SETS 

Journal data sets may be read in the following ways: 

• Offline 

• During execution of CICS/VS 

• Backward 

• Forward 

This section describes each of these methods. 
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READING JOURNAL DATA SETS OFFLINE 


Journal data sets may be read by user-written offline programs. 

Although written as operating-system undefined records by CICS/VS 
journal management, the blocks are compatible with records of the 
variable length blocked format. Each block begins with a fullword 
block-length field ( , LLbb , ) # and each logical record within a block 
begins with a fullword record-length field {’•'LLbb - ). 

The user is responsible for ensuring that journal volumes are read in 
the desired sequence. With disk journals which have two extents 
allocated (JTYPE=DISK2 specified in the JCT), the problem reduces to 
that of concatenating DD statements in OS and DLBL and EXTENT statements 
in DOS in the correct order. 

The user should be aware that unless a journal volume was 
successfully closed when last output during a CICS/VS execution, there 
may be no end-of-file indicator on the volume. 

Offline user-written programs may map journal records by issuing the 
macro instruction DFHJCR CICSYST=YES, which results in the DFHJCRDS 
DSECT being included in the program from the CICS/VS assembler-language 
macro library. The DSECT so generated is identical to that obtained for 
CICS/VS programs by the COPY DFHJCRDS, except that the fields are not 
preceded by a CICS/VS storage accounting area. The DSECT is intended to 
map journal records directly in the block, rather than in a CICS/VS 
storage area (see "Reading Journal Data Sets during CICS/VS Execution"). 


READING JOURNAL DATA SETS DURING CICS/VS EXECUTION 


Journals are designed to be high-usage, shared output files, and are 
normally opened for output at system initialization time. No master 
terminal facility is provided to prevent writing to a journal. This is 
in keeping with the primary function of journals, that is, to enhance 
the integrity of the data by providing audit trails and backup files. 

However, provision is made for reading journals online; the data can 
be read either forward or backward. To read a journal, a task must 
first close the journal, at which time the task is given exclusive 
control of the journal. Exclusive control is released when the task 
reopens the journal for output. While the journal is under the 
exclusive control of a task, output will not be attempted. If the task 
which owns the journal requests a write, control will be returned with 
an invalid-request condition. If any other task requests a write to the 
journal, that task will be put in a wait state until the journal is 
available for output. 

It is the user*s responsibility to release exclusive control of a 
journal by opening it for output. To ensure that this is done in case 
of abnormal termination of the controlling task, the user should 
establish an abend exit routine for the task through the DFHPC 
TYPE=SETXIT macro instruction or a HANDLE ABEND command. The exit 
routine should restore the journal to output status. 

Before a task which is expected to retain exclusive control of a 
journal for more than a few seconds is initiated, plans should be made 
to disable any other transactions which might issue requests to that 
journal. Disabling and enabling of transactions can be accomplished 
through the master terminal facilities of CICS/VS (see the CICS/VS 
Operator"s Guide) . 
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Because the format of journal tapes is compatible with that of 
extrapartition data sets, it is possible to read journals written 
| previously by means of the transient data facility, provided the 
| necessary entries have been added to the destination control table. 


READING A JOURNAL BACKWARD 


Certain functions may require access to a few journal records which were 
written in the preceding minutes of operation. The purpose of this 
action is usually corrective, such as for backing out updates to the 
data base by a task which subsequently terminated abnormally. The 
records to be retrieved would probably be the "before" image of data 
base records which were written to the system journal by the automatic 
journal feature.. Since this type of operation is likely to retain 
exclusive control of a journal for only a few seconds, it is unlikely 
that the user would want to disable other transactions which issue 
requests to the journal. The sequence of events considered here for 
this application might be as follows: 

1. A DFHJC TYPE=GETJCA macro instruction is issued to acquire a 
journal control area for the input records. 

2. A DFHJC TYPE=CLOSE,JFILEID=SYSTEM macro instruction is issued to 
close the journal file and give exclusive control to the requesting 
task. If the journal is on tape, LEAVE=YES is also specified so 
that the file will remain properly positioned after the last output 
block. 

3. A DFHJC TYPE=(OPEN,INPUT),VOLUME=CURRENT,JFILEID=SYSTEM macro 
instruction is used to open the journal for input, using the 
current tape volume or disk extent. This also implies that the 
journal is to be read backward beginning with the last output 
block. 

Note that standard tape labels should not be used for a journal 
which may be read backward because such a tape would be rewound at 
this time. 

4. DFHJC TYPE=GETB,JFILEID=SYSTEM,EOFADDR=address macro instructions 
are issued to read the journal records in reverse chronological 
sequence. Note that an attempt by this task to update the data 
base at this time could initiate a request for automatic journaling 
which in turn would return an invalid request condition because the 
system journal is closed for output. Instead, journal records to 
be used for later updating can be retained on the transaction* s 
storage chain, other journal records are discarded by issuing a 
DFHSC TYPE=FREEMAIN macro instruction. 

When the beginning of a tape reel or a disk extent is encountered 
while reading backward, an end-of-file condition is indicated. The 
user's end-of-file routine should switch to the preceding volume or 
extent by issuing the following macro instructions: 


DFHJC TYPE=CLOSE,JFILEID^SYSTEM 

DFHJC TYPE=(OPEN,INPUT),VOLUME^PREVIOUS,JFILEID=SYSTEM 

The positioning is again after the last output block on the volume 
or extent. If there is no previous volume, a VOLERR condition code 
is returned. 
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Note that for disk journals the one or two extents specified are 
periodically reused. An attempt to read backward so far that 
logical wrap-around occurs will usually result in an I/O error. 

The unlikely case that an I/O error does not occur can be detected 
by a sequence break in the time-and-date stamp in the journal 
record prefix. 

5. A DFHJC TYPE=CLOSE,JFILEID=SYSTEM macro instruction is issued to 
close the system journal for input after all desired records have 
been read. 

6. A DFHJC TYPE=(OPEN,OUTPUT),VOLUME=CURRENT, JFILEID=SYSTEM macro 
instruction is issued to release exclusive control of the system 
journal and make it available for output. If the journal is on 
disk, the data set is positioned after the last record written; if 
on tape, the VOLUME=CURRENT is ignored and output resumes with a 
new reel. 

The task can now process the records retained in step 4. 


READING A JOURNAL FORWARD 


Some application programs need to read large volumes of journal records. 
These application programs would typically take considerably more than a 
few seconds to execute, and would therefore only be practical if the 
journal is on tape and is not being accessed by any other task. The 
volumes being read would probably have been written and closed at some 
previous time, and would be defined as a separate journal table entry 
for the application program which reads them. 

For illustration, assume an application program which is to read 
previously written reels of the system journal. An entry is made in the 
journal control table defining this file as JFILEID=13. The sequence of 
events considered here for this application program might be as follows: 

1. A DFHJC TYPE=GETJCA macro instruction is issued to acquire a 
journal control area for the input records. 

2,. A DFHJC TYPE=CLOSE, LEAVE=NO, JFILEID=13 macro instruction is issued 
to close the journal file; the task is also given exclusive control 
of the journal. LEAVE=N0 causes the current output reel to be 
rewound and unloaded. Note that this journal, as all other 
journals, is opened for output at system initialization time, 
except when OPEN= DEFERRED has been specified in the journal control 
table. 

3. A DFHJC TYPE=(OPEN,INPUT),VOLUME=NEXT,SIVOL=YES,JFILEID-13 macro 
instruction is issued. VOLUME-NEXT causes the volume to be 
positioned to read forward beginning with the first block. 

SIVOL=YES requests a specific tape input volume. The program must 
have previously moved the volume identification of the first volume 
to be read into the journal control area. 

4. DFHJC TYPE=GET,EOFADDR=addr,JFILEID=13 macro instructions are 
issued to read the journal forward. Each request retrieves the 
next logical record. 

If an end of file is encountered and more records are to be read by 
the task, the following macro instructions are issued in the end- 
of-file routine: 
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DFHJC TYPE=CLOSE , JFI LEI D= 13 

DFHJC TYPE=(OPEN#INPUT),VOLUME=NEXT,JFILEID=13 

5. When all desired data has been read# a DFHJC TYPE=CLOSE#JFIELID=13 
macro instruction is issued to close the journal for input. 

6. A DFHJC TYPE=(OPEN,OUTPUT),VOLUME=CURRENT# JFILEID-13 macro 
instruction is issued to release exclusive control of the journal 
and make it available for processing by other tasks or for the 
system to close it at system termination time. This action will 
open a new tape volume and write a label on it. 

All journal data sets entered in the journal control table are 
normally opened for output during system initialization. The user may 
defer opening of selected journal data sets by specifying OPEN=DEFERRED 
in the journal control table. This could be used to allow a user 
program to open a journal for input to read the files written during a 
previous execution of CICS/VS. The user may want to execute this 
program during post-initialization processing by entering it in the 
appropriate program list table (PLT)• When the deferred open option is 
used# it is necessary for the program which first opens the journal to 
issue a special form of the DFHJC macro instruction in place of the 
normal DFHJC TYPE= GETJCA. It is: 


DFHJC TYPE=(GETJCA # OPEN),VOLUME=FIRST, 

JFILEID=nn # NORESP=symbol 

This macro instruction gives the requesting task exclusive control of 
the journal data set# acquires a journal control area# and collects the 
current extent pointer information if a disk file is referenced. The 
user may then issue a subsequent DFHJC TYPE=OPEN for input or output# 
current or previous volume according to the conventions described above. 
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Chapter 4.7. Warm Restart 


CICS/VS warm restart restores the status of the following information to 
their status at a previous warm shutdown of the CICS/VS system: 

• Intrapartition transient data 

• Processing program table (PPT) 

• Program control table (PCT) 

• Terminal control table for non-switched terminals and lines 

• Pile control table 

• Interval control elements 

• Automatic initiate descriptors 

• Batch control areas for asynchronous transaction processing (ATP) 

• Write request elements for ATP 

• Auxiliary temporary storage tables and the bit use map 

• Common system area parameters saved by the warm keypoint 

In some situations a full warm restart may not be necessary. The 
alternatives are a partial warm restart (where tables are individually 
warm or cold started), or a cold start. The system programmer * s only 
involvement in this facility is to define in the system initialization 
table which resources are to be restarted. 

The warm restart facility is only available after a previous 
controlled shutdown of CICS/VS (that is, when CSMT SHUT,NO has been 
issued). The facility may also be used after an abnormal shutdown. The 
ABKPOPT option in DFHSIT determines whether a warm keypoint should be 
taken during abnormal shutdown. Note, however, that if the system has 
protected resources, warm restart will not perform backout of any 
uncompleted changes made to these resources before the shutdown. Rather 
than perform a warm restart, an emergency restart should be made. 
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Chapter 4.8. Emergency Restart 


The following chapter contains information which the system programmer 
may require to implement the emergency restart feature of CICS/VS, which 
is invoked by specifying START=EMER or START=(EMER,ALL) as system 
initialization override parameters* Further informatiom on these 
parameters can be found in the appropriate CICS/VS System Programmer's 
Guide (DOS/VS or OS/VS). 

The following topics are discussed in this chapter: 

• "Problem determination" provides guidance on determining the cause 
of an abnormal system termination. It is possible that the same 
problem may also cause the emergency restart facility to fail. 

• "Transaction backout" describes the various aspects of the 
transaction backout program which may be used to backout the 
effects of transactions which were being processed when the system 
failed. 

• "Processing transaction backout data" describes the ways in which 
the system programmer may provide user-written data base recovery 
support. 

• "User activity keypointing" provides guidance on writing 
information to the system log for use during emergency restart. 


System failures during the emergency restart function represent one 
of the most difficult types of failures to diagnose and correct. 
Therefore, the user must be fully aware of the functions performed 
during emergency restart, the sequence in which these functions are 
performed, and the effect that abnormal termination during emergency 
restart has on data bases and tables. 


PROBLEM DETERMINATION 


Prior to initializing emergency restart, an analysis of the failure 
which caused the system to terminate should be performed. It is 
possible that the condition which caused the system to abend will also 
cause emergency restart to fail. One example of this is a physically 
damaged data set which caused a system abend, causing the identical 
failure to recur during emergency restart when the user attempts to back 
out updates to that data set. 

If a file control data set has become physically damaged, user- 
provided data set recovery program(s) will have to recover the data set 
prior to attempting to back out updates to this data set. Data set 
recovery involves restoring the contents of that data set from some 
previous copy and then applying all updates made to it since the copy 
was taken. CICS/VS automatic journaling can be used to keep track of 
data set updates performed during online execution. 

If the intrapartition transient data data set becomes physically 
damaged, it will not be possible for CICS/VS to perform emergency 
restart on it. CICS/VS recovery is dependent upon the physical location 
of data on this data set as it existed prior to system failure. 
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If any failure is encountered prior to completion of emergency 
restart, the following procedure must be followed: 

• Determine the cause of the failure: The cause of the failure of 
emergency restart must be determined and corrected. If the 
intrapartition transient data data set is damaged, it must be COLD 
started by CICS/VS (however, its contents may be restored by the 
user during post-initialization processing if possible). If a data 
base is damaged, it must be recovered by user data base recovery 
utilities. 

• Restart emergency restart: The emergency restart procedure is 
executed again using the OLD system log as input. The OLD system 
log is the volume which was being used for output when the original 
system failure occurred. Because this data set is not used for 
output during emergency restart, its contents are valid to use to 
restart the emergency restart procedure and recover CICS/VS to its 
status prior to abnormal termination. 

At the completion of emergency restart the recovered status of 
CICS/VS has been recorded on the NEW system log data set if system 
execution is to proceed, or on the system restart data set through the 
warm keypoint function if the system is to be terminated. This status 
represents the point of synchronization to which the system has been 
logically recovered. If restart becomes necessary from this point on, 
the new system log must be used for restart. 

If the system was terminated upon completion of emergency restart, 
the system restart data set contains the fully recovered CICS/VS status 
in the form of a warm keypoint. A CICS/VS warm start may be performed 
using this data set to initiate CICS/VS execution with the recovered 
system status. 


TRANSACTION BACKOUT 

CICS/VS users can provide their own transaction backout support 
following a CICS/VS system failure as described in "Processing 
Transaction Backout Data" later in this chapter, or can use the CICS/VS 
transaction backout program (DFHTBP). 

DFHTBP is responsible for backing out changes made to file control 
data sets, recoverable auxiliary storage temporary storage data sets, 
DL/I data bases, and recoverable intrapartition transient data, by 
transactions which were in-flight at the time that the system was 
interrupted. It is also responsible for collecting messages in support 
of message recovery and resynchronization following a system failure. 

DFHTBP provides exits and options that allow the user to participate 
in the recovery process with minimal programming effort. This section 
of the manual describes the functions performed by DFHTBP, the types of 
records logged by CICS/VS in support of data base backout and message 
recovery, and the user exits provided in DFHTBP. 

The following paragraphs are provided to clarify terms used in the 
description of DFHTBP. 

When the activity of a task affects a protected resource, recovery 
information relative to that activity is recorded on the system log, and 
the first such record associated with the task is flagged to indicate 
"start-of-task. w 

There is a point (or multiple points) in the life of a CICS/VS task 
at which all activity on protected resources is committed and cannot be 
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backed out. This point is known as the end of a logical unit of work 
("LUW" or "sync point") and its occurrence is recorded on the system 
log. These points correspond to user sync point requests during the 
transaction. 

A task can explicitly declare that it has reached a point in 
processing at which all activity to that point is to be considered 
committed by issuing a CICS/VS DFHSP (sync point) request. Once the end 
of the LUW has been recorded on the system log, the task will begin its 
next LUW and the first record written to the system log (because of the 
task f s activity in the new LUW) will also be flagged as "start-of-task." 
Therefore, a single task can have multiple LUWs, intermediate sync 
points between LUWs being explicitly declared, and a final LUW which 
ends implicitly when the task terminates. CICS/VS treats each LUW as a 
recoverable process and will back out the effect the task had on 
recoverable resources during an LUW if CICS/VS is abnormally terminated 
before a task completes that LUW. A task in this state at the time of 
abnormal termination is called "in-flight." 

An output message whose delivery was deferred until after the 
completion of an LUW is called a committed output message. Even after 
delivery of a committed output message has been initiated, its receipt 
is considered "in-doubt" until a definite response has been received by 
CICS/VS and the response has been recorded on the system log. 
Resynchronization involves restoring the inbound and outbound sequence 
numbers assigned to message traffic to some agreed-upon values, and 
requires the participation of CICS/VS and intelligence at the terminal. 
Because the recovery/restart philosophy of CICS/VS is backing out the 
effect that in-flight tasks had on recoverable resources, 
resynchronization can result in backing up these sequence numbers to a 
point prior to task initiation (in effect ignoring the existence of 
physical messages sent and received during the life of the in-flight 
task). These sequence numbers (collectively) are called "resync data." 


Initialization 


DFHTBP is invoked by the system initialization program (SIP) in an 
emergency restart situation after the recovery utility program (RUP) has 
completed its processing. The function of RUP is to identify all in¬ 
flight tasks and their associated log records from the CICS/VS system 
log. RUP writes this information to the restart data set. 

During the initialization phase, DFHTBP reads, from the restart data 
set, the transaction backout table, the message backout table, the file 
backout table, and the DL/I backout table. 

The transaction backout table contains an entry for each in-flight 
task that accessed a recoverable resource, or caused journal records to 
be written to the system log prior to an abnormal termination of 
CICS/VS. DFHTBP does not use the contents of the table, but does make 
it available to user exits. 

The message backout table contains an entry for each in-flight task 
involved in the sending or receiving of recoverable terminal messages or 
that caused journal records representing terminal messages to be written 
to the system log prior to an abnormal termination of CICS/VS. Further, 
an entry is created for each task that had terminated and the delivery 
of its final output message was in-doubt (a definite response had not 
been received and logged by CICS/VS) prior to the system failure. 

DFHTBP verifies that the terminals identified in the message backout 
table exist in the terminal control table used for the current execution 
of CICS/VS. The address of the corresponding TCTTE (if present) is 
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placed in the table entry, or the table entry is flagged as "absent" and 
that no action is to occur. 

The file backout table contains an entry for each in-flight task that 
accessed a recoverable file or caused journal records representing file 
activity to be written to the system log prior to an abnormal 
termination of CICS/VS. DFHTBP verifies that the files identified in 
the file backout table exist in the file control table used for the 
current execution of CICS/VS. The address of the corresponding FCT 
entry (if present) is placed in the file backout table entry, or the 
entry is flagged as "absent" and that no action is to occur. DFHTBP 
also checks the initial status of the files as described in the FCT 
entries (that is, deferred open, disabled, and so on) and flags the file 
backout table entries to indicate which temporary status changes are 
required during data base backout processing. 

DFHTBP writes a list of "absent" file IDs to the transient data 
destination "CSMT" and also displays the same list on the console with 
either a "GO" or a "CANCEL" option. 

If "GO" is selected the user initialization exit is given control, 
and the user may examine the four tables above and may mark any 
additional entries for "no action." Upon return from this exit, DFHTBP 
performs the temporary status changes for all files requiring action 
(including opening deferred-open files and so on) and proceeds to read 
the data records placed on the restart data set by RUP. 

The DL/I backout table contains an entry for each in-flight task that 
was scheduled for DL/I resources. DFHTBP first verifies that the PSBs 
in use by these tasks exist in the PSB directory and that they can be 
scheduled. Then the DMBs that are referenced by the above PSBs are 
checked in the same way in the DMB directory. If a PSB or DMB is not 
found, or cannot be scheduled, an indication is set in the DL/I backout 
table entry and the entry is marked for "no-action." If a data base is 
marked for "deferred open" in the file control table, the DL/I backout 
table entry is flagged and the data base name is kept in a list. 

DFHTBP writes a list of missing and/or unschedulable PSB and/or DMB 
names to the transient data destination "CSMT", and also displays the 
same list on the console with either a "GO" or "CANCEL" option. 

When each data record is read, (if it is not a record that was 
written to the log by DL/I) it is passed to the user input exit where 
the user may examine it, process journaled records as required, and 
select appropriate DFHTBP processing options upon returning. The 
records are presented to the exit in a LIFO sequence, that is, in the 
same sequence as they appeared on the system log when read backward by 
RUP. After the last data record has been processed, DL/I backout is 
performed and DFHTBP gives control to a user termination exit. Upon 
return, DFHTBP terminates. 

The next four sections describe the data base backout, temporary 
storage backout, DL/I backout, and message recovery processes performed 
by DFHTBP. The system programmer should realize that the selection of 
which process is performed is based upon the type of data record read 
from the restart data set. Those representing file control program 
activity are processed for data base backout. Those representing 
storage program activity are processed for temporary storage backout, 
while those representing DL/I activity are processed for DL/I backout. 
Those representing terminal control program activity are processed for 
message recovery, and all other records are ignored by DFHTBP. 

| Transaction backout runs under the control of terminal control's task 
j control area (TCA). If insufficient storage is available for 
j transaction backout (causing the short-on-storage condition to occur), 
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| terminal control's TCA may be suspended and the system will stall. It 
j is, therefore, in the interest of all users to ensure that sufficient 
j storage is available for emergency restart to be performed without 
j causing the short-on-storage condition. 


Data Base Backout 


The default data base backout processing performed by DFHTBP involves 
restoring the contents of recoverable files altered by in-flight tasks 
prior to a system failure. Records contained on the restart data set 
were written to the system log by the file control program when task 
activity altered the contents of recoverable files (as specified by 
LOG=YES when generating the FCT entries). The following chart details 
the type of activity written to the system log and how DFHTBP backs out 
that activity for in-flight tasks. 

Online Operation 

Not logged. No backout is 
required. 

The before-copy of the record is 
logged. This copy is reapplied 
to the file. 

Not logged, because the preceding 
online GET-UPDATE is logged and 
used by DFHTBP for backout. 

The ID and data of the added 
record are logged, although only 
the ID is used by DFHTBP to delete 
the record for VSAM KSDS files. 

For ISAM, BDAM, and VSAM ESDS files, 
no delete function exists. In these 
cases, the user file error exit is 
given control if a record exists. 
However, if a preceding GET-UPDATE 
issued by DFHTBP results in a 
"no-record-found* condition, the 
add did not take place, and no backout 
is required. 

PUT-DELETE (VSAM KSDS only) Not logged, because the preceding 

online GET-UPDATE is logged and 
used for backout. To back out, 
a GET-UPDATE is issued by DFHTBP. 

If it fails, a PUT-NEWREC is issued 
to reapply the GET-UPDATE logged 
record. 

DELETE (VSAM KSDS only) This is treated as a GET-UPDATE, 

PUT-DELETE combination. 

In addition to the user input exit, a file error exit is provided in 
support of data base backout. This exit is given control in the event 
of errors being encountered during the default data base backout 
processing. The same exit is given control to allow the user to 
participate in the deletion of records added to ISAM, BDAM, and VSAM 
ESDS data sets. The exit can logically "mark" the record as "deleted" 
according to application-dependent protocols. Upon return from the 


GET only 
GET-UPDATE 


PUT-UPDATE 


PUT-NEWREC 
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exit, a PUT-UPDATE is issued by DFHTBP to reapply the "marked" record to 
the file. 

A successful execution of DFHTBP is dependent upon how the system is 
generated and how it is initialized. The file control program (DFHFCP) 
should be generated to support all needed functions (for example, VSAM 
DELETE if VSAM additions are to be backed out). The FCT should also be 
generated to allow 'reverse* operations on data sets where updates have 
taken place and the same FCT is used when emergency restarting. 

However, if the FCT does not allow operations needed to back out, DFHTBP 
will temporarily change the FCT so that the operations can take place. 
This is done after the user-initialization exit, so that if the user 
does not want this to take place, the appropriate file backout table 
entry can be marked for "no action" in the exit. 


Temporary Storage Backout 

DFHTBP participates in the recovery of auxiliary temporary storage by 
backing out the effect of "replace" requests made to recoverable 
temporary storage destinations by tasks that were in-flight at the time 
the system was interrupted. The remaining temporary storage recovery 
process is performed by the temporary storage recovery program 
(DFHTSRP). 

Temporary storage "PUT(Q)-REPLACE" requests to recoverable 
destinations (defined in the TST), cause the contents of the records 
being replaced to be recorded to the system log. The user input exit is 
given control before DFHTBP processes the record, where the user may 
elect to have the recorded data ignored. The default temporary storage 
backout processing causes the before-copy of the record to be reapplied 
through a "PUT(Q)-REPLACE" request. This effectively restores the 
original record in temporary storage. 


Message Recovery and Resvnchronization 


CICS/VS support of message recovery and resynchronization is restricted 
to logical units, and is dependent upon the online capabilities of the 
specific devices involved in the exchange of message traffic. The 
CICS/VS VTAM terminal control program (DFHZCP) performs the online 
logging operations associated with message recovery and 
resynchronization. Message recovery requirements and/or options are 
specified for the transactions in the program control table (PCT). When 
a task is initiated, CICS/VS verifies that the message requirements 
specified for the task can be satisfied by the logical unit to which the 
task is connected, before allowing the task to run. The message 
recovery and resynchronization process described here assumes that the 
terminal can support a task's characteristics of PROTECT in its message 
option group (see "Program Control Table" in Chapter 3.2 of this 
manual). 

The purpose of the message recovery and resynchronization facility of 
CICS/VS is, in case of an emergency restart, to: 

• Support resynchronization of message traffic between CICS/VS and 
logical units that can participate in this function. 

• Make available to the user, the originating input message for in¬ 
flight LUWs and/or the committed output message for the last 
successfully completed LUW for a logical unit. 
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• Make available for automatic representation to the logical unit, 
the committed output message for the last successfully completed 
LUW whose delivery was in-doubt at the time of the abnormal 
termination. 

Note ; Resynchronization and automatic representation are not available 
for 3270, 3270 compatibility mode, interactive, and 3770 batch logical 
units. All other facilities are available. 


Data Written to System Log 


The following information is written to the system log. 

• For message-originated transactions, the originating input message 
is logged together with resynchronized data (sequence numbers prior 
to task initiation).. The logging is performed by the start-up-task 
subroutine in ZCP. This logging is performed so that, in case of a 
system breakdown before the task completes (and logs) an LUW, this 
message can be collected during the backward scan of the log and 
made available to the user. The resync data is used to 
resynchronize message traffic with the logical unit. 

• The first input message for a LUW (after a preceding sync point) is 
logged together with resynchronized data. This is done by the 
application request routine in ZCP. The reason for this logging is, 
the same as above. 

• For transactions which are not initiated by transactions, resync 
data only is logged by the ZCP start-up-task subroutine. This 
logging is performed so that, in case of a system breakdown before 
the task completes (and logs) a LUW, this resync data is used to 
resynchronize message traffic with the logical unit. 

• For any outstanding write operation, at sync point time, the output 
message and resync data are logged. The logged message can be 
identified as requiring (or not requiring) definite response. If 
it requires a definite response, it is defined as a committed 
output message. This logging is performed so that, in case of a 
system breakdown sometime in the next LUW, DFHRUP will, during the 
backward scan of the log, collect this message and make it 
available to the user. Thus, the user has access to the last 
output message for a completed LUW. However, if this sync point 
was caused by a task detach, and was successfully logged, the 
message is not collected unless it is a committed output message 
for which a definite response is absent on the log. Resync data is 
used only if the message is collected. 

• For tasks that do not have any outstanding write operation at sync 
point time, only resync data is logged. The reason for this 
logging is to be able to resynchronize message traffic with the 
logical unit even though no message is part of this LUW. 
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• For committed output messages, the receipt of the required response 
is logged. 

If the preceding sync point was caused by task detach, and thus the 
TCA has been freed, the logging is performed by a special task 
attached by ZCP. 

If the preceding sync point was caused by a user request, the 
response logging is performed by the sync point subroutine in ZCP 
under the user TCA. The response is logged so that, if a system 
breakdown occurs before a response is logged, the in-doubt 
committed output message can be collected and made available to the 
user. 

• The periodically taken activity keypoint includes data to be used 
for message recovery and resynchronization. The data keypointed 
includes TCTTE identifications of logical units waiting for 
responses to committed output messages. 

The reason for this logging can be explained as follows: 

Suppose a task ends with a logging of a committed output message as 
part of its last sync sequence Can activity keypoint is then 
recorded on the log) and a system breakdown occurs before the 
response is logged. The keypoint tells DFHRUP to continue the 
backward scan and collect the in-doubt committed output message for 
possible representation later. 

The default message recovery processing performed by DFHTBP examines 
each ZCP-created system log record retrieved from the restart data set 
if logical unit recovery action is to be taken. The presence of any 
message indicates that resynchronization with the logical unit is to 
occur. RUP has primed the appropriate message backout table entries 
with the resync data (sequence numbers). DFHTBP moves this information 
to the corresponding TCTTEs and sets indicators showing that the logical 
unit is in an emergency restart status and that resynchronization should 
occur. 

A copy of each "in-doubt" committed output record read by DFHTBP is 
written to a temporary storage "resend slot" with the data-ID of 
DFHZxxxx (where "xxxx" is the symbolic terminal ID). RUP identifies 
messages whose committed output is "in-doubt" by setting an indicator in 
the appropriate record. The messages in the "resend slots" are 
available when the logical unit connection has been reestablished and 
the results of resynchronization indicate a particular "in-doubt" 
message was not received and, therefore, should be retransmitted. 

DFHTBP sets an indicator in the appropriate TCTTE showing that an "in¬ 
doubt" message has been saved for representation. Each "resend slot" 
can only contain one message and is in the standard journal control 
record format. 

A copy of each committed output record (whether "in-doubt" or not) 
and each initial input message for an in-flight task's LUW is written to 
a temporary storage message cache of DFHMxxxx (where "xxxx" is the 
symbolic terminal ID). The messages in each message cache are available 
for user examination and are intended as an aid in determining which 
activity had completed and/or was backed out as a result of a CICS/VS 
system failure. Each message cache can have multiple entries, and can 
contain the results of multiple emergency restart situations. They are 
temporary storage queues and it is the user'* s responsibility to release 
their contents. The records are standard journal control record format. 
The following summary recaps the combinations of records that can appear 
in each message cache for each emergency restart situation. 
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• A single "in-doubt" committed output record ("in-doubt" identified 
in the system prefix of the journal control record) indicates that 
the LUW represented by the message had completed, but that delivery 
of the message was in-doubt at the time of the system failure. 

This message is also saved in a "resend slot." The task either 
terminated, or was awaiting receipt of the response and, therefore, 
had not started a new LUW. Resynchronization uses the sequence 
numbers at the time this message was initially sent. 

• A single "not-in-doubt" committed output record indicates that the 
LUW represented by the message had completed, and that delivery of 
the message had been confirmed prior to the system failure. The 
message itself may reflect which activity should be started next, 
as well as which activity has been completed. The task, however, 
had not terminated and may have started a new LUW which was backed 
out. In this case the task had not requested terminal input during 
the new LUW (typical for output-only type tasks with multiple 

LUWs)• Resynchronization uses the sequence number at the time the 
response was logged. 

• A single initial input record indicates that the task was in-flight 
and, therefore, the interrupted LUW was subject to backout during 
emergency restart. The task was either in its first LUW, or if it 
had completed a prior LUW, there was no final output message 
associated with the prior LUW (typical for input-only type tasks 
with multiple LUWs). The message itself may reflect which activity 
was backed out and may indicate that the process should be 
reinitiated by the user later. Resynchronization uses the sequence 
numbers prior to the time the message was received (those as of the 
last successful completion of a prior LUW of this or a prior task 
having message recovery support). 

• An initial input record followed by a "not-in-doubt" committed 
output record indicates that the task was in-flight and, therefore, 
the interrupted LUW was subject to backout during emergency 
restart. This is based on the presence of an initial input record. 
The presence of the committed output record indicates the task had 
started a new LUW and the prior LUW associated with the committed 
output record had completed successfully. Both messages may 
reflect which process should be reinitiated by the user later. The 
two records are in the sequence described above, which is the 
sequence in which they appeared on the system log when read 
backward by RUP. Resynchronization uses the sequence numbers at 
the time the response to the committed output was logged. 

Journaled records representing message input and/or output are 
ignored by DFHTBP. However, their presence will cause resynchronization 
to be scheduled when the terminal connection is reestablished. 
Resynchronization uses the sequence numbers as of the completion of a 
prior task having message recovery support, if the task causing the 
records to be written did not have message recovery support. 


Transient Data Recovery 


Intrapartition transient data destinations (specified in the DFHDCT 
TYPE=INTRA macro) may be defined as recoverable in order to permit 
rebuilding in the event of abnormal system termination (that is, of the 
partition, of CICS/VS, of the operating system, or of the transaction). 
Information is recorded on the system log in order to effect recovery. 
The type of recovery specified determines the status to which the 
destination and DCT entry will be restored. 
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If a destination is defined as physically recoverable (DESTRCV=PH), a 
record is written on the system log using information from the 
destination"s DOT entry upon first PUT to the queue, on every GET, and 
prior to a RELEASE or PURGE. Upon emergency restart of CICS/VS 
following an abnormal system failure, the DCT entry for a physically 
recoverable destination is restored to reflect the physical status of 
the destination in the event of abnormal termination,. The queue is not 
under exclusive control of the task; therefore data from other tasks may 
be interspersed in it. If the destination was being written, all 
records will remain intact, that is, after recovery the DCT will point 
to the next record on the queue to be written. If the destination was 
being read, the DCT will be restored so that the first record to be read 
following recovery will be the last record that was read prior to 
abnormal termination. 

If a destination is defined as logically recoverable (DESTRCV=LG), a 
record is written on the system log using information from the DCT entry 
at a sync point, which delimits a logical unit of work (LUW) which is 
that point in a task * s execution when a complete transactional function 
has been performed. It may occur at the end of a task or may be 
explicitly defined in the transaction through the DFHSP TYPE=USER macro 
instruction). The queue is under the exclusive control of the task. 

The first task to access the queue will enqueue upon the destination 
and thus "own" it for the duration of the task. Two tasks may enqueue 
upon the destination if one is reading and the other is writing. This 
prevents interspersing data from multiple tasks and allows transaction 
backout of transient data. Upon emergency restart or dynamic 
transaction backout of CICS/VS following an abnormal system failure, the 
DCT entry is restored to reflect the logical status of the queue as it 
was at the last sync point prior to abnormal termination. This means 
that any GETS or PUTS to the queue made by a transaction which was in¬ 
flight Chad not completed) at the time the system or the transaction 
abnormally terminated, or which terminated itself abnormally and for 
which dynamic transaction backout was specified, will be backed out 
automatically either at the time of the transaction failure or when the 
system is emergency restarted after a total system failure. An input 
destination is restored to the status which existed at the completion of 
the last task which had read from it. An output destination is restored 
to the status which existed at the completion of the last task which had 
written to it. 


DL/I Backout 


After data base backout, temporary storage backout, and message recovery 
have been performed, DFHTBP will backout the effects of the in-flight 
tasks against DL/I data bases based on the PSBs that were scheduled at 
system failure. This is done one PSB at a time. First, a "PCB" call is 
issued to schedule the PSB, then records are read from the restart data 
set. Each record that relates to the PSB is passed to the DL/I backout 
module (DFSRDBCO for OS/VS or DLZRDBCO for DOS/VS) to do the physical 
backout. When all records have been read from the restart data set, a 
"TERM" call is issued to unschedule the PSB, and processing continues 
with the next PSB in the DL/I backout table. 

A DL/I error exit is provided in support of DL/I backout. This exit 
is given control in the event of errors occurring while DL/I backout is 
being attempted. These errors include those encountered during PSB 
scheduling and unscheduling, as well as those encountered while 
attempting physical backout. 
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User-written Exits for the Transaction Backout Program 


User exits provided by DFHTBP are included through the standard methods 
used for other CICS/VS management modules (see "Creating User Exits for 
CICS/VS Management Modules" in Chapter 6.2). However, because of its 
specialized processing nature during an emergency restart, DFHTBP user 
exits must conform to some conventions not applicable to other 
management module exits. 

Each user exit in DFHTBP is invoked through a BALR R14,R14 
instruction. Each exit must save all registers temporarily (in the CSA 
is acceptable), must finally establish its own base register, and must 
finally move the saved registers from the CSA to a 64-byte save area 
defined in the exit logic itself. This form of non-reentrant coding is 
acceptable, because DFHTBP is not executed in a multitasking 
environment. The following is a recommended coding technique for the 
exits written for DFHTBP: 


START DS OH 


First statement in exit code 


ENTRY1 


ENTRYn 


SAVEREGS 


DS OH 

STM 0,15,CSA0SRSA+ 8 
BALR Rl, O 
USING *,Rl 
L Rl,=A(START) 

USING START,Rl 

MVC SAVEREGS,CSA0SRSA+8 


LM 

BR 


DS OH 


DS OF 
DS XL64 


LTORG 

END DFHTBPNA 


Exit entry point 


(Repeat above for each 
exit entry) 

(Alignment) 
save area 


Last statement in exit code 
Last statement in DFHTBP 


0,15,SAVEREGS 

R14 Return to DFHTBP 


Registers R12, R13, R14, and R5 contain the addresses of the TCA, 
CSA, DFHTBP return point, and DFHTBPs initial base register 
respectively, upon entry to any DFHTBP user exit. Other registers may 
contain specific information depending on the particular exit. These 
are covered individually in the following text as the exits are 
discussed. 

The user has access to all other CICS/VS services, except terminal 
control services, during exit execution. However, the following 
restrictions should be considered: 
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• An exit must not release, or cause to be released, any file control 
area pointed to by the register FWACBAR as a result of DFHTBP 
processing. 

• If an exit causes an area to be acquired as a result of a file 
control request, it is the responsibility of the exit to cause the 
release of that area. 

• An exit must not attempt to make any file control requests to a 
VSAM data set with a string number of one (1), unless "no action" 
has been specified for that file during the user's initialization 
exit. 

• The processing of DFHTBP and its exits is performed under the 
control of terminal controls TCA. Therefore, any service request 
must not cause the task to be suspended (an interval control WAIT, 
for example, will cause the system to terminate abnormally). 

• Task chained storage acquired in an exit will be released at the 
completion of emergency restart processing. However, the exit 
should attempt to release the storage as soon as its contents are 
no longer needed. 

• No exit should reset either the "absent" or "no action" indicators 
set by DFHTBP,. 

• Only the initialization/termination exit can set the "no action" 
indicators in the file, message, or DL/I backout table entries. 

Refer to Chapter 6.2 for instructions on supplying the entry 
addresses for these exits,. 

Four user exits are provided: 

1. The initialization/termination exit is given control on three 

different conditions, each identifiable by appropriate reason codes 
in the communication byte TBXITCOM. 

a. Table initialization — Four tables have been read from the 
restart data set: the transaction backout table (DSECT 
DFHTBODS) is pointed to by the field TBTBOAD; the file backout 
table (DSECT DFHFBODS) is pointed to by TBFBOAD; and the 
message backout table (DSECT DFHMBODS) is pointed to by 
TBMBOAD; and the DL/I backout table (DSECT DFHDBODS) is pointed 
to by TBDBOAD. The entries in the file, message, and DL/I 
backout tables have been verified against the loaded file 
control table, terminal control table, and DL/I PSB and DMB 
directories respectively, and marked as "absent" and "no 
action" if unmatched. Also the file and DL/I backout table 
entries have been flagged if temporary status changes are 
required during backout processing. DSECTs for the FCT and 
TCTTE have been provided in DFHTBP. TBXITCOM is set to 
TBINITTP indicating initial table processing. The exit may 
scan the various tables, marking additional file and message 
backout table entries for "no action." Upon return from the 
exit, DFHTBP will open the files and make the temporary status 
changes, unless "absent" or "no action" is indicated for the 
entries. Prior to giving control to the exit, DFHTBP has 
written a list of "absent" file IDs and missing or 
unschedulable PSB and DMB names to the "CSMT" transient data 
destination and to the console operator with a "GO" or "CANCEL" 
option. The exit is only given control if the "GO" option is 
selected. 
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b. Open errors — The exit is given control if an error occurs 
while opening a file control data set. In this case, TBXITCOM 
is set to TBINITOE, and the symbolic register FBOREG points to 
the file backout table entry for which the error occurred. A 
message has been written to CSMT and to the console operator 
with a "GO" or "CANCEL" option. The exit is only given control 
if the "GO" option is selected. Upon return from the exit, the 
file backout table entry is marked "no action" by DFHTBP. 

c. Termination — The exit is again given control just prior to 
terminating DFHTBP. The communication byte TBXITCOM is set to 
TBTERMIN. The addresses of the various tables previously 
described under "Table Initialization" are still available to 
the exit. Upon return from the exit, DFHTBP will restore the 
temporary status changes made and close or disable any 
appropriate files (unless "no action" is indicated). DL/I data 
bases, if specified as deferred in the FCT, will be closed. 

The initialization/termination exit must always return to DFHTBP 
through a BR14 instruction (there are no processing options 
available to this exit). 

If no initialization/termination exit is provided, DFHTBP will 
continue with its normal processing. 

2. The input-exit is given control each time a record (other than a 
DL/I record) has been read from the restart data set. At that 
time, the symbolic register JCRREG points to the record, which 
should be addressed by using DSECT DFHJCRDS. The type of record 
can be determined by testing field JCRSTRID with the symbolic codes 
provided by "DSECT" DFHFMIDS. In case of a record written by the 
file control program, the symbolic register FBOREG points to the 
corresponding DFHFBO-entry. In case of a record written by the 
terminal control program, the symbolic register MBOREG points to 
the corresponding DFHMBO-entry. The communication byte TBXITCOM is 
not applicable in the input-exit . 

If the default action by DFHTBP is desired upon return from the 
input-exit, return should be made through a B 0(,R14) instruction. 
If no action is desired, return should be made through a B 4(,R14) 
instruction, in which case the record area will be freed 
immediately and a new record will be read. 

The default DFHTBP-actions are: 
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For user journaled records: 

For automatic journaled 
records: 

For logged records applying 
to files or terminals flagged 
for "no action": 

For logged "read-updates": 


For logged "write-add": 


For logged temporary storage 
"PUT(Q)-REPLACE": 


For logged terminal messages: 


No action 


No action 


No action 

Reapply before-copy of 
the record to the file* 

The user*s file error 
exit (see below) is 
given control for ISAM, 
BDAM, and VSAM ESDS files* 
For VSAM KSDS files, the 
default action is to delete 
the record. 

Reapply the before copy of 
the record to temporary 
storage. 

Save the records in the 
temporary storage "resend 
slot" and/or "message 
cache" as appropriate. 


3. The file-error-exit is given control when some error condition has 
been returned from the file control program during the backout 
processing or if an error has been detected by DFHTBP itself. 


Symbolic register JCRREG points to the record read from the restart 
data set, and should be addressed using DSECT DFHJCRDS. Symbolic 
register FBOREG points to the corresponding DFHFBO entry. Except 
as indicated below, the file-error-exit has no processing options 
and should return to DFHTBP through a BR14 instruction. The 
communication byte TBXITOM is primed for different type of errors 
as follows: 


TBFEGU 

If an error response is returned from FCP while servicing a 
GET-UPDATE-request. DFHTBP has attempted to retrieve the 
existing copy of the record prior to backing it out. The 
file control CHECK macro in combination with the type of 
record pointed to by JCRREG ("before-copy" of a read-for- 
update record, or "new-copy" of a "write-add" to be 
deleted) can be used in the exit to determine the specific 
problem. 

TBFELE 

If the FWA acquired from FCP is not big enough to receive 
the before-copy data from the restart data set to perform 
the backout. The symbolic register FWACBAR points to the 
FWA on entry to the exit. The file control CHECK macro is 
not applicable to this error. 

TBFEPU 

If an error response is returned from FCP while servicing a 
PUT-UPDATE-request. DFHTBP has attempted to replace the 
existing copy of the record on the file with the "before¬ 
copy" pointed to by JCRREG. The file control CHECK macro 
can be issued in the exit to determine the specific error. 
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TBFEPN 

If an error response is returned from FCP while servicing a 
PUT-NEW-request. DFHTBP has attempted to add the "before- 
copy" of a deleted VSAM-KSDS data set record. The file 
control CHECK macro can be issued in the exit to determine 
the specific error. 

TBFEWA 

If the record read from the restart data set is a WRITE- 
ADD f the record is also read in from the file through a 
GET-UPDATE. For ISAM, BDAM, and VSAM-ESDS data sets, no 
delete function exists. The user is given the opportunity 
to "mark" the existing record on the file as deleted 
according to application-dependent logic. The FWA-version 
of the record should be marked. If the user wants the FWA 
version to be reapplied, return should be made through a B 
0(,R14) instruction. If the user does not want this, but 
would rather bypass the operation, return should be made 
through a B 4(,R14) instruction. 

Symbolic register FWACBAR points to the FWA containing the 
existing record on the file. The file control CHECK macro 
is not applicable to the error. 

TBFEVD 

If an error response is returned from FCP while servicing a 
VSAM-DELETE request. DFHTBP has attempted to delete a new 
record added to a VSAM-KSDS data set. The file control 
CHECK macro can be issued in the exit to determine the 
specific error. 

4. The DL/I error-exit is given control when any error is encountered 
during DL/I backout. These errors include attempting to schedule, 
or unschedule, a PSB as well as those encountered during physical 
backout. 

Symbolic register DBOREG points to the corresponding DFHDBO entry,. 
The area labeled READAREA contains the log record (if any). The 
communication byte TBXITCOM is primed for different types of errors 
as follows: 

TBDBUNSC 

If an error is returned from DL/I while attempting to 
schedule a PSB. 

TBDBUNBO 

If an error is returned from the DL/I backout module 
(DFSRDBCO for OS/VS or DLZRDBCO for DOS/VS) while 
attempting physical backout. 

TBDBUNTR 

If an error is returned from DL/I while attempting to 
unschedule (terminate) a PSB. 

The exit is given control to determine whether the error should be 
ignored. The default action upon return from the exit is to 
sustain the error by writing a message to transient data 
destination CSMT and to the console operator with a "GO" or 
"CANCEL" option. If the "GO" option is selected, the error is 
ignored and processing continues. If the default action is to be 
taken, return should be made through a BR R14 or a B 0(,R14) 
instruction. If the exit determines that the error is to be 
ignored, return should be made through a B 4(,R14) instruction. In 
this case, processing will continue with no messages sent to 
transient data destination CSMT or to the system console. 
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TEMPORARY STORAGE EMERGENCY RESTART 


Temporary storage emergency restart provides for recovery of auxiliary 
temporary storage data following an abnormal termination of CICS/VS. 
During an emergency restart, CICS/VS will restore the control blocks for 
data placed on auxiliary temporary storage during the previous 
execution. The user has the option of specifying which auxiliary 
temporary storage is to be recoverable by generating a table (TST) which 
is referenced during normal operation. The table contains the leading 
characters of DATAIDs for which recovery processing is to be performed. 
This provides the capability of designating generic classes of data to 
be recovered following abnormal termination. In addition, temporary 
storage emergency restart provides for backing out changes made to 
recoverable data by in-flight transactions at the time of abnormal 
termination. 

Interval control data recovery, an integral part of auxiliary 
temporary storage emergency restart, ensures that data placed on 
auxiliary temporary storage by an interval control PUT request, is 
restored and that the transaction originally scheduled to process that 
data is re-scheduled following abnormal termination. This means that 
data scheduled for processing at some future time will be restored and 
processing rescheduled during emergency restart. 


PROCESSING TRANSACTION BACKOUT DATA 


CICS/VS provides the user with the transaction backout program in 
support of data base recovery, or the user can write his own support. 
This section provides some guidelines for users who wish to perform 
their own data base recovery. 

During an emergency restart, the system log is automatically 
repositioned after the last record written during the previous 
execution. The recovery utility program (DFHRUP) reads this data set 
backward in order to process system recovery data and to collect user 
recovery backout data. The backward scan is completed and more user 
records cannot be collected when the following conditions are met: 

• At least one complete activity keypoint (delimited by end and start 
of keypoint records) has been retrieved. 

• The start of all logical units of work (LUWs) which were in-flight 
at system abend time have been reached. 

• Committed output messages logged for recovery purposes have been 
collected from the previously completed LUWs. 

During the backward scan, DFHRUP outputs the following data to the 
restart data set: 

• Records output to the system log by tasks (LUWs) that did not 
complete processing before the system abnormally terminated (that 
is, in-flight tasks). These records follow the standard journal 
control record layout, have the flag JCSPRRIF set ON in field 
JCSPF1, and are as follows: 

Records automatically logged by the file control program for 
data sets with the specification LOG=YES in the FCT. 


432 


CICS/VS System Programmer"s Reference Manual 



Records automatically journaled to the system log by the file 
control program (FCP), according to the user-specified option 
in the FCT. 

Records automatically logged or journaled to the system log by 
the terminal control program for tasks defined in the 
appropriate PCT entries. These records should be ignored for 
data base recovery. 

Note : The field JCRSTRID in the prefix area indicates the type 

of record, and the DFHFMIDS should be copied into user programs 
reading these records. It contains the symbolic codes for the 
the type of record. For a more detailed description of these 
records, see "Layout and Contents of Journal Records" in 
Chapter 4.6. 

Records written to the log by DL/I. These records do not have 
the normal CICS/VS log record prefix. The first byte of the 
field JCRSTRID will be non-zero and less than hex * 80*. 

User-journaled records to the system log that were output by 
in-flight tasks,. 

Note : User-journaled records with the high-order bit set ON in 

the JTYPEID and which are encountered during the backward scan, 
are copied over to the restart data set regardless of the 
status of the task (in-flight or complete). If the task was 
completed, the flag JCSPRRIF is OFF in field JCSPF1. User- 
written activity keypoint records in the last completed 
activity keypoint are always copied to the restart data set. 
User activity keypoint records in other completed keypoints 
that are encountered in the backward scan of the log are only 
copied if the high-order bit in JTYPEID is on . 

• The transaction backout control record contains an entry for each 
task in-flight at the time the system abnormally terminated. The 
entries are defined by the DFHTBODS DSECT, which should be copied 
into the user program. 

There are two types of entries in the transaction backout control 
record: 

In-flight tasks - These are tasks that have caused records to 
be written to the system log, but failed to complete before 
system failure. No special start-of-task record is written to 
the system log, but the first record logged for the task is 
flagged as being start-of-task. When DFHRUP reads the log 
backward, and the first record found for a task is one other 
than an end-of-task record, this task is considered in-flight. 
DFHRUP must then find the corresponding start-of-task 
indication to complete the collection of recovery backout data 
for this task. Long running tasks should be divided into LUWs 
by means of the DFHSP macro instruction (as described in the 
CICS/VS Application Programmer's Reference Manual ). In this 
case, the start and end of task are logical , thus reducing the 
backward scan necessary for DFHRUP. 

Active tasks - These are tasks that did complete a LUW and 
started another, but did not cause any records to be written to 
the system log during this LUW. Thus, during DFHRUP 
processing, a completion of a LUW was found, but no physical 
end-of-task (that is, task DETACH) was found. 


Chapter 4.8. Emergency Restart 


433 




1 DFHKP Macro Instructions 


The following DFHKP macro instructions are provided for users who wish 
to perforin their own methods of data base recovery. The macro 
instructions ares 


• DFHKP TYPE=RTBOCTL - to read a transaction backout control record 
into storage 

• DFHKP T YPE=RTBODATA - to read transaction backout data records 

• DFHKP TYPE=RTBOEND - to reset the pointer in order to read more 
transaction backout data 

• DFHKP TYPE=CHECK - to check the response to a previous DFHKP macro. 


I Read Transaction Backout Control Record 


A macro instruction is provided to read the transaction backout control 
record into dynamic storage as follows: 


r- r —- r --- 

j | DFHKP j TYPE=RTBOCTL, 

| j j l ,EOFADDR=symbolic-address] 

j j | (,IOERROR=symbolic-address] 

j j | t r NORESP=symbolic-address] 

t-L_L___ 


I 

I 

I 

I 


TYPE=RTBOCTL 

indicates that the transaction backout control record is to be 
read from the restart data set. CICS/VS obtains an area for 
the record and returns the address to the user in the fullword 
field TCAKPDBA. 


EOFADDR=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if no control record exists on the 
restart data set-. 


IOERROR and NORESP=symbolic-address 

can be specified with this macro instruction or through DFHKP 
TYPE=CHECK. The meaning of each operand is discussed under 
"Test Response." 


I Read Transaction Backout Data 


| The following macro instruction is provided to read transaction backout 
data records: 
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r 


r - r - 

j DFHKP j TYPE=RTBODATA 
| j [,EOFADDR=symbolic-address] 

j j | £,IOERROR=symbolic-address] 

j j j [,NORESP=symbolic-address] 

l-l-l_ 


i 

I 

I 

I 

I 

.j 


TYPE=RTBODATA 

indicates that the backout data, beginning with the latest 
backout record, is to be read from the restart data set. The 
data is retrieved sequentially in chronologically descending 
order. CICS/VS obtains the area for the record and returns it 
to the user in the fullword field TCAKPDBA. It is the user's 
responsibility to free the area when it is no longer needed. 


EOFADDR, IOERROR and NORESP=symbolic-address 

can be specified with this macro instruction or through a DFHKP 
TYPE=CHECK. The meaning of each operand is discussed under 
| "Test Response." 


I Reset Transaction Backout Pointer 


The user may read the transaction backout data again by issuing the 
following macro instruction: 


| DFHKP | TYPE=RTBOEND 


TYPE=RTBOEND 

specifies that the user has logically or physically finished 
reading transaction backout data, and the pointer to the next 
backout record is to be reset. After this is done, the next 
DFHKP TYPE= RTBODATA macro instruction to be issued will read 
the first backout record in the restart data set. 


I Test Transaction Backout Response 


The format of the macro instruction which may be used to test the 
response to a request for transaction backout data is as follows: 


r i— _ —r 

j DFHKP j 

TYPE=CHECK 

1 1 

[,EOFADDR=symbolic-address] 

I 1 1 

[ , IOERROR=symbolic-address] 

i 1 1 

L— L -- 1. 

[,NORESP=symbolic-address] 


TYPE=CHECK 

indicates that the response to the preceding DFHKP macro 
instruction is to be checked. 
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EOFADDR=symbolic-address 

specifies the entry label in the user-written routine to which 
control is to be passed if an end-of-file condition occurs 
during the file operation* 


IOERROR=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if an unusual event occurs during the 
file operation. 


NORESP=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if no error occurs. NORESP signifies 
"normal response." 


USER ACTIVITY KEYPOINTING 


An activity keypoint is taken periodically in order to record on the 
system log the information necessary to restore recoverable resources 
during emergency restart and to determine which tasks were in-flight at 
the time of the system failure. This function is performed by attaching 
transaction CSKP at a frequency which is a function of output operations 
to the system log. The user can define this frequency at system 
generation or initialization time and can alter this frequency at any 
time during execution. 

The frequency of the activity keypoint and the amount of logging 
performed by in-flight transactions determine the amount of log data to 
be processed at restart time and thus the duration of the recovery 
process. 

The user may include his own keypoint records in the keypoint 
sequence. This is accomplished by a conditional DFHPC LINK request to 
user program DFHUAKP. This program should be used to record a limited 
amount of user selected data (that is, tables to be restored upon an 
emergency restart). It should be written to avoid suspension of the 
keypoint task (that is f program and work areas should be resident). It 
is recommended that this program issue only CICS/VS journal control 
functions. In order to perform efficiently, the journal control 
requests should be asynchronous (that is, WRITE without WAIT) and with 
STARTIO=NO, because this system will force synchronization by writing a 
synchronous end of keypoint record upon return from the user program. 

The user should assign his own identification (JTYPEID=) with the high- 
order bit on to these records, in order to make them accessible from the 
restart data set in an emergency restart. (For information on 
retrieving these records, see "Processing Transaction Backout Data" 
above.) 
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Chapter 4.9. Multiprocessor Recovery Procedures 


For some conditions of partial system failure on an 0S/VS2 Release 3.7 
(MVS) system running on an IBM multiprocessor, appropriate system or 
CICS/VS operator action can reduce the disruption of service that online 
CICS/VS users experience. This chapter provides CICS/VS-specific 
information to enable this to be done. The information should be used 
in conjunction with the OS/VS2 MVS Multiprocessing; An Introduction and 
Guide to Writing Operating and Recovery Procedures , GC28-0952, manual, 
which provides more detailed information on the topics discussed in this 
chapter. 


PLANNING 


The key to successful recovery in the event of partial system failure is 
pre-planning. This takes two forms: 

• Configuring the system for availability. This includes ensuring 
that: 

the manual switching equipment is available so that BTAM/TCAM 
devices can be switched between the processors 

the network control program (NCP) for VTAM is symmetrically 
attached to the multiprocessing system 

the hardware recovery enhancements shippable unit (SU55) is 
installed on MVS so that channel failures are recovered more 
effectively 

at least one device can be used as a CICS/VS master terminal, 
whichever processor fails. 

• Recovery procedures, which include: 

using terminal list tables for groups of terminals (for 
example, all those on a processor or channel), which are 
predefined to CICS/VS to minimize the number of commands to be 
issued 

ensuring that the appropriate CICS/VS broadcast capability is 
generated in CICS/OS/VS 

using procedures stored in SYS1.PR0CLIB to minimize the number 
of system commands issued 

ensuring that the procedures are kept up-to-date as the system 
configuration changes 

testing the recovery procedures by simulating errors. 
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DETERMINING THE APPROPRIATE ACTION 


The flowchart in Figure 4.9 at the end of this chapter shows the 
questions that must be answered before the appropriate action can be 
determined. The action boxes, representing specific procedures to be 
followed, are discussed in the sections which follow. Procedures for 
VTAM, BTAM, and TCAM environments are given and apply only to cases in 
which CICS/VS is still running and a terminal is still available for use 
as a master terminal. 


RECOVERY PROCEDURES FOR A VTAM NETWORK 


CICS/VS must be closed down in order to reconnect logical units attached 
through VTAM. This should be done by using the CSMT SHUTDOWN command. 
The exact options needed are installation-dependent, and are affected by 
whether teleprocessing access methods other than VTAM are being used, 
and whether there is a PLTSD (a set of programs in the program list 
table that is to be executed during system termination) that must be 
specified for this type of shutdown. 

VTAM restart procedures must be prepared and can be effected before, 
after, or during CICS/VS shutdown. 

CICS/VS can be restarted after both VTAM has been restarted and 
CICS/VS has been shutdown, by using the procedure normally used to 
restore a temporary loss of service. However, if a warm keypoint is 
taken, a cold start of the terminal control table may be advisable 
because logical units may have been placed out of service because of the 
VTAM failure. 


RECOVERY PROCEDURES FOR A BTAM ENVIRONMENT 


For the purposes of this discussion, it has been assumed that 
asymmetrically connected lines and channel-attached 3270s connected to 
the processor which fails can be manually switched between the 
processors. 

There are two possible situations: 

1. Channel reconfiguration hardware (CRH) is available. This hardware 
allows the remaining processor to access the channels of the 
processor that has failed in a degraded mode. 

2.. Channel reconfiguration hardware (CRH) is not available. 


BTAM Recovery with CRH 


The following general procedures should be adapted to the specific 
requirements of the installations: 

1. Broadcast a message to all users connected to the failed processor. 

2. Quiesce all remote I/O by placing all remote lines connected to the 
processor that fails out of service, using CSMT commands. 
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3. Manually switch asymmetric lines and local 3270 control units to 
the remaining processor. 

4. Issue VARY PATH commands to the OS/VS2 Release 2 or later (MVS) 
operating system to cause MVS to use the newly established paths to 
the devices, and to delete the CRH path. 

5. Reenable the lines and place them back in service by using CSMT 
commands. 

6. Place those local 3270s that may be out of service back in service 
by using CSMT commands. 


BTAM Recovery without CRH 


To effect recovery in a BTAM environment when channel reconfiguration 
hardware is not available, the following procedures should be adapted to 
suit the specific requirements of the installation: 

1. Manually switch the transmission control unit (TCU) and the local 
3270 control units to the remaining processor. 

2. Issue VARY PATH commands to MVS first to cause the operating system 
to use the newly established paths to the devices and then to 
delete the paths that are unavailable. This is only needed to 
prevent MVS from trying to use the paths on the processor that 
failed when it comes back in service. 

3. Issue CSMT commands to reenable the remote lines that are out of 
service, and place the lines that were switched over back in 
service. 

4. Issue CSMT commands to place back in service any terminals that 
were placed out of service because of the errors that occurred. 


FURTHER CONSIDERATIONS BTAM RECOVERY 


The CICS/VS terminal list table can be used to reduce the number of 
commands needed to be issued to CICS/VS. This, however, does not solve 
the problem for the set of commands required to manipulate lines. If 
the number of commands is likely to be large, a user-written transaction 
to perform the functions required may be appropriate. 

Multiple commands to the MVS operating system can be stored in the 
system cataloged procedures library (PROCLIB) and can be executed on 
demand by a START command. 

The CICS-related IBM program (number 5798 ANK) "CPU Console as CICS 
Master Terminal" may be useful to an installation in order to avoid any 
difficulties that may arise if the terminal normally used for master 
terminal commands is a BTAM terminal that is asymmetrically connected to 
the processor that fails. 
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RECOVERY PROCEDURES FOR A TCAM ENVIRONMENT 


In the majority of cases, if TCAM fails CICS/VS will also have failed. 

If CICS/VS is still active, the CICS/VS system must be brought down to 
allow TCAM restart to be followed by CICS/VS restart,. 

If TCAM does not fail, some devices may no longer be accessible 
because they were asymmetrically connected to the processor that failed. 

Recovery procedures for TCAM are similar to those already discussed 
for a BTAM environment. The major difference is that instead of using 
CICS/VS CSMT commands to perform the quiescing and reenabling of the 
line, the MVS operator commands VARY $$$,OFF TP (to quiesce), and VARY 
$$$,0N TP (to reenable and restart) must be used. These commands can be 
included in PROCLIB members and can be executed via the START command* 



Figure 4.9. Multiprocessor Recovery: Actions to be Determined 
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Chapter 4.10. Program Check 


When a serious error such as a program check occurs in a CICS/VS 
partition, the operating system abnormally terminates all processing in 
that partition unless the error can be corrected or ignored. The error 
recovery action can be taken by a program in the partition, provided 
that the operating system has been given the address of this program 
before the error occurs. In CICS/VS, the address is that of the system 
recovery program (SRP) and is specified during system initialization. 
The function of the system recovery program is to gain control when an 
error in a CICS/VS partition threatens to terminate all CICS/VS 
processing. The system recovery program then determines whether to: 

• Recover from the error and avoid shutdown by terminating the 
CICS/VS task in error, or 

• Take action during the shutdown to help correct the error and make 
a quick restart possible. Generally, this action consists of 
recording information useful in a CICS/VS restart-. 

The system recovery program is functionally divided into two parts: 

• Program check recovery 

• Partition abend recovery. 

To handle program checks the operating system returns control to the 
program check section of the SRP, which may then either: 

• Abnormally terminate the CICS/VS task in error with the code ASRA 

• Abnormally terminate all CICS/VS processing 
depending on tests which the SRP applies. 

Details on how to generate the system recovery program can be found 
under DFHSG PROGRAM=SRP in Chapter 2.2 of this manual. 
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Part 5. Device and Access Method Support 




Chapter 5.1. Introduction 


| This part of the manual contains a discussion on the CICS/VS system 
I programmer's role in providing support for various access methods, such 
j as the use of VTAM with logical units, and the TCAM (both SNA and non- 
| SNA) interface to CICS/OS/VS. In addition. Part 5 also provides a 
| summary of the system generation and table preparation options which 
j must be specified to provide support for such devices as the 3270 in 
| 2260-compatible mode, the 3735, the 3740, and the 3600 on BSC lines, 

| Information is also given on how to IPL the System/7. 

| Part 5 is organized in the following manner: 

5.2. 

| VTAM Logical Units with CICS/VS - which provides a general 

description of system programmer functions available for 
implementing and maintaining CICS/VS features for logical 
units. 

5.3. 

| The CICS/OS/VS TCAM Interface - which gives information on 

implementing the TCAM interface to CICS/VS, allowing CICS/VS to 
run as an application program under TCAM. 

5.4. 

Writing A Transaction to IPL The System/7 - which provides 
information on how to write a transaction to IPL the System/7 
on start/stop and BSC lines. 

5.5. 

2260 Compatibility for the 3270 - which describes the system 
programmer's responsibilities for generating the support 
required for running 2260-based transactions from a 3270. 

5.6. 

| IBM 3735 Programmable Buffered Terminal - which contains 

information on the system generation and table preparation 
specifications required to generate support for the 3735 
programmable buffered terminal. 

5.7. 

| IBM 3740 Data Entry System - which gives similar information on 

the 3740 data entry system. 

5.8.. 

| IBM 3600 Finance Communication System (BSC) - which gives 

similar information on 3600 BSC devices. 
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Chapter 5.2. VTAM Logical Units with CICS/VS 


In an SNA teleprocessing network, the remote work station is not always 
simply a terminal. Rather, the terminal is typically one of several 
attached to a terminal controller. Furthermore, the terminal controller 
may contain one or more user-written programs. In SNA terminology, 
however, the remote entity with which the CICS/VS application program is 
communicating is always a logical unit . This chapter provides a general 
description of system programmer functions available for implementing 
and maintaining CICS/VS features for logical units. The operands of the 
CICS/VS macro instructions referred to in this chapter are described in 
Parts 2 and 3 of this manual. 

The system programmer should refer to the appropriate CICS/VS 
subsystem guide for a full discussion of the logical unit being used. 
These guides are: 

• IBM 3600/3630 Guide 

• IBM 3650 Guide 

• IBM 3767/3770 Guide 

• IBM 3790 Guide 


OVERVIEW OF SYSTEM PROGRAMMER REQUIREMENTS 


The system programmer responsible for logical units in a CICS/VS working 
environment has three main divisions of responsibility: 

• Generating a network control program/virtual storage (NCP/VS) to 
control the transfer of data between the host processor and the 
nodes of the logical unit teleprocessing network — The NCP/VS 
resides in a communications controller. Because CICS/VS does not 
interface directly with the NCP/VS, this chapter contains no 
information concerning NCP/VS generation. The system programmer 
must consult Introduction to the IBM 3704 and 3705 Communications 
Controllers . 

• Defining a VTAM system which supports telecommunications within the 
CICS/VS subsystems. A brief discussion of the VTAM definition 
procedure related to system programming functions is presented in 
this chapter; a general description of the VTAM definition 
procedure is given in the VTAM Concepts and Planning manual. 

• Defining a CICS/VS system that supports the subsystem hardware 
configuration and desired programming configuration — This chapter 
discusses this requirement, but it describes only the modifications 
and additions to CICS/VS system programming functions that relate 
to CICS/VS subsystem support. 

• Correctly configuring the SDLC terminal controller and writing the 
necessary programs to control the terminals which are attached to 
it and which are to communicate with CICS/VS. 

When planning for CICS/VS support of logical units under VTAM, the 
system programmer must be concerned with the following facilities: 
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• VTAM support requirements for the logical units 

• Connection, input, and output services 

• Basic mapping support (BMS) services for the appropriate devices 

• The node abnormal condition program (DFHZNAC), the function of 
which is to handle abnormal situations involving a logical unit and 
to allow the system programmer to generate the node error program 
(NEP) to perform error handling 

• Message option groups Cto be referenced by the program control 
table (PCT) entry for a task) which permit certain processing and 
logging characteristics to be associated with a transaction 

• A terminal control macro interface which provides additional system 
programming capabilities 

• The option to code user exit-routines to be activated during 
processing of a request by the terminal control management module 
(DFHZCP) 

• Collection of statistics that can be used for system tuning 

• Message switching facilities for certain logical units 

The explanations of these facilities and of related concepts involving 
CICS/VS system programming responsibilities in a VTAM network are 
discussed below. 

| Chapter 5.3 provides information on system programming 
j responsibilities in a TCAM SNA network. 


BASIC CONCEPTS 


The system programmer must understand several new concepts and 
facilities that are basic to his involvement in generating and 
maintaining CICS/VS support of logical units. They are: 

• An additional terminal control program module (DFHZCP) to support 
VTAM services 

• VTAM indicators (SNA commands) and responses 

• The need to communicate with logical units 


TERMINAL CONTROL PROGRAM DUAL MODULE GENERATION 


VTAM is the required access method interface between CICS/VS and logical 
units. The non-VTAM terminal control program (DFHTCP) does not provide 
the required support for VTAM capabilities; VTAM support is available 
only through the CICS/VS VTAM terminal control programs. 

DFHTCP and the ZCP group of programs are two separate collections of 
modules, generated when DFHSG PROGRAM=TCP is specified. They are always 
assembled separately and loaded separately. The ZCP group of programs 
is always generated, even for a non-VTAM system, because it contains 
some internal routines which are necessary for the successful operation 
of DFHTCP. VTAM support within the ZCP group is generated by specifying 
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| ACCMETH=VTAM in the DFHSG PROGRAM=TCP macro instruction; the VTAMDEV 
| operand of this macro instruction controls any device-dependent code 
j that must be generated within the ZCP group for the VTAM-supported 
logical units under CICS/VS. The ACCMETH and VTAMDEV operands must be 
specified to provide support for CICS/VS logical units under VTAM. 

The TCP and ZCP operands of the DFHSIT TYPE=CSECT macro instruction 
| specify the suffixes of DFHTCP and the ZCP group, respectively, to be 
| loaded by the system initialization program (DFHSIP). If TCP=NO is 
| specified, no DFHTCP load is performed. In contrast, specifying ZCP=NO 
j does not suppress the ZCP group; this is because, as explained earlier, 
j the ZCP group is always generated with DFHTCP, whether or not VTAM 
support is subsequently generated. 


VTAM INDICATORS (SNA COMMANDS) 


A CICS/VS interface with terminal control allows the system programmer 
to write routines that request the sending of SNA data flow control 
commands from CICS/VS to the application program of certain logical 
units. For example, a function provided by a VTAM indicator may be 
needed in the installation's error recovery routine (DFHZNEP). In the 
case of certain logical units, the system programmer should use the 
indicator interface (DFHTC CTYPE=C0MMAND macro) to request a VTAM 
function, rather than directly alter bits in the TCTTE. Any direct 
changing of bits leads to unpredictable results if any future changes 
are made in the TCTTE internal structure. 

VTAM indicators are always sent by CICS/VS with definite function- 
management-end (FME/DR1) response requested, whether they are sent on 
behalf of a system programmer request or a CICS/VS management module 
request. CICS/VS DFHZCP calls the appropriate routine and returns 
control to the requestor when the response is received. 

The VTAM indicators that are available for use by the system 
programmer are described under DFHTC CTYPE=COMMAND in "Modifying the 
Terminal Control Table" in Chapter 6.5 of this manual. 

VTAM indicators are also used by CICS/VS management modules. The 
system programmer should thoroughly understand each indicator before 
using it. The system programmer should also understand how and when 
they are used by CICS/VS; misusing any of them can lead to unpredictable 
results. 


CONNECTION SERVICES 

Before any communication between CICS/VS and the logical unit can occur, 
CICS/VS must first be connected to VTAM. The CICS/VS system 
initialization program (DFHSIP), which is generated in the DFHSG 
PROGRAM=CSO macro instruction, issues the appropriate VTAM macro 
instruction to open the CICS/VS access method control block (ACB) to 
accomplish such a connection. This identifies CICS/VS to VTAM as one of 
its application programs. Only then can VTAM honor a request to connect 
a logical unit to CICS/VS and thus allow communication between these two 
nodes. A logical unit which is connected to CICS/VS is said to be owned 
by CICS/VS for the duration of the connection. 

The CICS/VS APPLID operand provides the name that DFHSIP uses when 
opening (and closing) its ACB to define itself to VTAM during CICS/VS 
| system initialization or by using the master terminal dynamic open 
| facility for the ACB. The system programmer may specify the APPLID 
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operand either in the DFHTCT TYPE=INITIAL macro instruction or in the 
DFHSIT TYPE=CSECT macro instruction, or in both (to permit variable 
generation of the ACB). If the operand is specified in both macro 
instructions, the name supplied through the DFHSIT macro instruction 
overrides that supplied by the DFHTCT macro instruction at CICS/VS 
system initialization; otherwise, DFHSIP opens the ACB using the name 
supplied through the terminal control table (TCT). Only one APPLID, 
chosen in this manner, is used by CICS/VS per initialization* Any name 
coded with either APPLID operand must have been defined during VTAM 
definition using VTAM's APPL statement* 

To build the access-method-dependent portions of the TCT for VTAM 
support, the system programmer must specify ACCMETH=VTAM with the DFHTCT 
TYPE=INITIAL macro instruction. If ACCMETH is omitted, the current 
default value is NONVTAM. The former default value of BTAM is, however, 
still valid. Specification of either NONVTAM or BTAM permits existing 
TCTs to be assembled without change. 

The system programmer controls the connection services available for 
a particular logical unit through the DFHTCT TYPE=TERMINAL macro 
instruction. ACCMETH=VTAM must be specified to create the necessary 
VTAM TCTTE for each logical unit. For each TCTTE, CICS/VS automatically 
creates an accompanying node initialization block (NIB) by issuing the 
VTAM NIB macro instruction. The NIB is used to convey several operating 
parameters that apply to the connection being established. These 
parameters are established during VTAM definition and cannot be altered 
by the CICS/VS user. The NIBs are grouped apart from the TCTTEs because 
they are used only by VTAM to process OPNDST requests, and are not 
involved during normal logical unit I/O processing. The VTAM OPNDST 
request causes VTAM to establish the connection between CICS/VS and the 
logical unit. This connection is called an SNA session and is completed 
when the logical unit sends a positive response to the SNA BIND command 
sent by VTAM as the result of the OPNDST request. CICS/VS supplies BIND 
parameters to VTAM which are sent with the BIND command. The parameters 
tailor operation of the logical unit to CICS/VS requirements for the 
duration of the session. Different BIND parameters are used by CICS/VS 
for different logical unit types. There is one version of each set of 
BIND parameters in the BIND CSECT for each different type of BIND used 
by CICS/VS. 

The NETNAME operand of the DFHTCT TYPE=TERMINAL macro instruction 
provides the symbolic name for the logical unit by which it is known 
throughout the network. This is the name which CICS/VS specifies in the 
NAME operand of VTAM*s NIB macro instruction to identify the logical 
unit that is represented by this TCTTE in CICS/VS. The same symbolic 
name must also be defined to VTAM during VTAM system definition through 
the logical unit macro instruction and to the NCP/VS during NCP/VS 
generation. 


LOGON 


Once CICS/VS has been connected to VTAM, any logon requests for CICS/VS 
are passed to CICS/VS (unless the MACRF=LOGON operand of the ACB macro 
instruction was specified during VTAM definition, in which case VTAM is 
not allowed to queue any logon requests for CICS/VS). In general, the 
CICS/VS logon exit is scheduled by VTAM in response to a request 
initiated either by CICS/VS or by a logical unit. 

To specify that a simulated logon is to be performed for a particular 
logical unit, the system programmer must specify the CONNECT=AUTO 
operand of the DFHTCT TYPE=TERMINAL macro instruction. When CICS/VS 
issues the VTAM SIMLOGON macro instruction in response to a CONNECT=AUTO 
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specification, it also supplies the address of the particular request 
parameter list (RPL) which contains the address of the NIB whose NAME 
field identifies the logical unit for which the simulated logon request 
is to be performed* This drives the logon exit logic in DFHZCP to 
establish connection with the logical unit. If CONNECT=AUTO is not 
specified, the logical unit is not connected to CICS/VS at system 
initialization, but awaits either a master-terminal operator connection 
request, a logical unit logon initiated by the VTAM network operator, or 
a terminal operator logon from a logical unit,. 

CICS/VS logical unit support provides a RELREQ exit-routine so that 
any other VTAM applications wishing to use a logical unit currently 
owned by CICS/VS can indicate their needs. When no more work is 
available for the requested logical unit, CICS/VS checks whether it is 
permitted to release it. (The RELREQ operand of the DFHTCT 
TYPE= TERMINAL macro instruction defines whether or not a logical unit 
can be released by CICS/VS.) If it can be released, the existing 
connection is broken. 

Conversely, CICS/VS can also request the use of a logical unit 
currently owned by another VTAM application program. For example, a 
SIMLOGON is always performed with the RELREQ and RPL options so that 
CICS/VS can indicate its need of the logical unit to any VTAM 
application program that currently owns it. 


INPUT SERVICES 


Input services handle both data from the logical units and asynchronous 
input such as VTAM indicators. This section describes CICS/VS data 
input in general; VTAM indicators, as they relate to the system 
programmer, are described in "Basic Concepts" earlier in this chapter. 

CICS/VS receives user data into the system at two different times. 

The first is when data is entered to create a new user transaction. The 
other is in response to a CICS/VS application program request for data 
from a logical unit. To satisfy these two different situations, CICS/VS 
uses two distinct kinds of VTAM RECEIVE macro instructions. 

To obtain transaction-originating data, CICS/VS puts all logical 
units that have no tasks attached into the VTAM continue-any state* The 
VTAM RECEIVE macro instructions with the OPTCD^ANY operand are then 
issued by CICS/VS to allow any data entered by the logical unit to be 
received. The system programmer controls the number of such receive-any 
macro instructions issued, by specifying the number of RPLs to be 
generated. The RAPOOL operand of the DFHTCT TYPE=INITIAL macro 
instruction is used to specify the fixed number of RPLs that are 
generated in the TCT prefix. 

CICS/VS issues a receive-any for each RPL not currently in use, if 
fewer than the maximum allowable number of tasks are running and the 
short-on-storage condition is not present. (The sum of receive-anys 
outstanding plus the number of active tasks never exceeds the maximum- 
task value.) When the number of active tasks reaches this level (as 
specified in the DFHSIT TYPE=CSECT macro instruction), no new tasks can 
be initiated by DFHZCP, so no receive-anys are issued until the 
condition is relieved. 

The number of RPLs required is dependent on the expected activity of 
the system, the average transaction lifetime, and the maximum-task value 
specified. To aid the system programmer in choosing a size for the RPL 
pool, CICS/VS keeps a count of the maximum number of RPLs in use at any 
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one time, plus how many times this maximum was reached. (See 
"Statistics" later in this chapter.) 

Associated with each receive-any RPL is an I/O area, the size of 
which is specified by the RAMAX operand of the DFHTCT TYPE=INITIAL macro 
instruction. If the input length exceeds the size of this I/O area, 

VTAM gives CICS/VS only as much of the data as fits into the CICS/VS I/O 

area, and tells CICS/VS how much was received in total. CICS/VS then 

handles the data in one of two ways: 

• If the data length is less than RAMAX multiplied by RATIMES (also 

specified by the system programmer in the DFHTCT TYPE=INITIAL macro 
instruction), CICS/VS obtains an area large enough to accommodate 
the data through its storage control program, and then receives the 
rest of the input data kept by VTAM (because all of it did not fit 
into the CICS/VS I/O area). 

• If the data length exceeds the RAMAX times RATIMES value, an 
exception response, indicating data over-length, is sent by the 
node abnormal condition program (DFHZNAC) to the terminal. This is 
not true, however, for 3270s or when the chain assembly feature is 
being used. Any data length (up to the VTAM buffer limits) is valid 
from 3270s when chain assembly is being used. 

The RAMAX and RATIMES operands apply to all TCTTEs (except 3270s and 
logical units using chain assembly). The optional TIOAL operand of the 
DFHTCT TYPE=TERMINAL macro instruction is provided so that the system 
programmer may specify the minimum size of a TIOA for a particular 
TCTTE. If specified, this is the minimum size TIOA that the CICS/VS 
application program expects to receive. If TIOAL is not specified, 
there are no minimum size requirements, and the input data is sent in a 
TIOA, of length equal to that of the data, to the CICS/VS application 
program. Therefore, if TIOAL is greater than RAMAX, the length 
specified in TIOAL is passed to the application program regardless of 
the actual length of the input data. 

The system programmer can also specify a minimum size for the 
receive-any I/O area through the RAMIN operand of the DFHTCT 
TYPE=INITIAL macro instruction. RAMIN is the size below which any input 
is transferred from the receive-any I/O area to a new TIOA. The length 
of this new area depends on which logical unit sent the data, and its 
size is the greater of the data length itself or TIOAL. This allows the 
CICS/VS application program to receive an I/O area length at least as 
large as it expects. 

To obtain data in response to a read requested by a CICS/VS 
application program, DFHZCP issues a VTAM RECEIVE macro instruction with 
the OPTCD=SPEC operand to allow data from a specific logical unit to be 
received. The data is received directly into the user TIOA? no separate 
receive-specific I/O area is provided. 

Each input message is called a chain. If its length exceeds the 
maximum output buffer size for the terminal (RUSIZE in DFHTCT 
TYPE=TERMINAL), the message will be broken up into a series of links (or 
request units) not exceeding this buffer size. The VTAM RECEIVE macro 
obtains only a single request unit at a time. The system programmer may 
control whether a CICS/VS application program input request is to be 
satisfied by a single request unit or by the assembled chain of request 
units. This control is provided by the CHNASSY operand of the DFHTCT 
TYPE=TERMINAL macro. 
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OUTPUT SERVICES 


Output services handle both data to the logical units and asynchronous 
output such as VTAM indicators and commands. This section describes 
CICS/VS support of data output in general; VTAM indicators, as they 
relate to the system programmer, are described in "Basic Concepts" 
earlier in this chapter. 

When generating support for the available output services, the system 
programmer has the following main areas of responsibility: 

• Determining the maximum data length that each logical unit can 
receive. This value is specified by the BUFFER operand of the 
DFHTCT T YPE=TERMINAL macro instruction, except for 3270 logical 
units, which use segmenting with the BUFFER size set to zero. If a 
message longer than this value is to be sent, it is broken into as 
many links (request units) as necessary. Each link has a maximum 
size equal to the BUFFER value; the first link may contain the SNA 
function management header (FMH), but the total length of this 
first link (including the FMH) does not exceed the value of BUFFER. 
The default value is zero, which specifies that the data should not 
be chained but should be sent just as it is presented to DFHZCP by 
the CICS/VS application program. 

The value specified in the BUFFER operand must not exceed the 
logical-unit buffer size minus the buffer prefix size, as specified 
to NCP/VS. (For information on specifying the buffer prefix size 
see the IBM 3704 and 3705 Communications Controller Network Control 
Program/VS Generation and Utilities Guide and Reference Manual (for 
OS/VS and DOS/VS VTAM Users .) 

• Specifying the response level (either FME/DR1 or RRN/DR2) to be 
used by CICS/VS when transmitting user data. This is specified in 
the RESP operand of the DFHTCT TYPE=INITIAL macro instruction and 
applies to all logical units; this level is used for both normal 
and exception response requests. The default value is FME. Only 
FME is valid for 3270s. The responses FME and RRN are also known 
as DR1 and DR2, respectively. 

• Controlling the DELAY or IMMED processing option by specifying the 
TIOTYPE operand of the DFHPCT TYPE=ENTRY macro instruction. The 
IMMED parameter specifies that the operation is to be performed as 
soon as the DFHTC macro instruction is issued; the DELAY parameter 
specifies that the operation is to be delayed until the application 
program issues a wait or otherwise relinquishes control. The 
default value for TIOTYPE is DELAY. The application programmer may 
also specify this option through the IOTYPE operand of the DFHTC or 
DFHBMS macro instructions. The following table defines the 
combined effect of the DELAY and IMMED requests. 


DFHTC TYPE=< READ ) , 
(WRITE) 
IOTYPE= 

DFHPCT 

DELAY 

TYPE=ENTRY, 

TIOTYPE= 

j IMMED 

DELAY 

DELAY 

1 

l 

DELAY 

IMMED 

IMMED 

1 

I 

IMMED 

(unspecified) 

DELAY 

1 

l 

JL 

IMMED 


The above table is subject to the following condition: 
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If the task is protected, all tranmissions are delayed until 
another DFHTC macro instruction is issued or until the task 
terminates. All reads are delayed until a task wait occurs. 


MESSAGE RECOVERY AND EMERGENCY RESTART 


Two distinct environments exist which require message recovery: 

• Catastrophic failures 

• Noncatastrophic failures 

A catastrophic failure is one in which either CICS/VS abnormally 
terminates, or some other failure (such as power loss or machine check) 
causes host processing to be abnormally terminated. 

A noncatastrophic failure is one in which a particular connection is 
interrupted because of some malfunction in the network. Both CICS/VS 
and the logical unit remain operational, but cannot communicate with 
each other because of the failure. In this case, the CICS/VS node 
abnormal condition program (DFHZNAC) is invoked to terminate the task. 

The primary objective of the message recovery procedure is to 
ascertain whether or not a message that was in-flight when a failure 
occurred was delivered to its destination. 

Following a catastrophic system failure, several CICS/VS facilities 
and techniques are used for message recovery: 

• The protected task and the deferred write, which govern the logging 
and response activities during normal transaction processing 

• The system log, which enables CICS/VS to reconstruct the 
environment for any connection (represented by a TCTTE) that had a 
terminal message in-flight at the time of a failure 

• The temporary storage message cache, which contains information 
related to the failing task 

These facilities and techniques are discussed in the following 
paragraphs. Refer to the CICS/VS System/Application Design Guide for 
further information about recovery, restart, and emergency restart. 


CATASTROPHIC FAILURES 

During a catastrophic failure, CICS/VS does not have an opportunity to 
record any information concerning messages that are in-flight at,the 
time of the failure. Therefore, selected parts of the message traffic 
(outbound messages preceeding a synchronization point or the detachment 
of the task and the initial input for a task and any input that follows 
a synchronization point) must be recorded on the CICS/VS system log 
during normal operation so that message recovery during emergency 
restart can be performed. Information concerning a message is recorded 
on the system log only for messages associated with a task that is 
protected. 

Before describing the recovery techniques employed by CICS/VS, the 
protected task concept must be explained. This concept is relevant to 
the system programmer’s decisions concerning the message option group 
which he must specify if he wants to achieve a controlled and 
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predictable situation for the message traffic. The message option group 
(described below) is a program control table (PCT) function that permits 
the specification of the CICS/VS support necessary for message 
protection. 


Protected Tasks 


If a system failure occurs and CICS/VS emergency restart is necessary, 
message recovery is possible only if the task in-flight at the time of 
the failure was protected. CICS/VS keeps a system log of messages 
preceeding a synchronization point or task detach only for tasks which 
are declared as protected. During recovery, output messages are not 
retransmitted for certain logical units even if the DFHSG PROGRAMMESP 
macro instruction includes RESEND=YES, because certain logical units do 
not support the set and test sequence number (STSN) command. The user 
can retransmit messages using information in the temporary storage 
message cache (DFHM "termid"). 

The process of logging information for protection against a 
catastrophic system failure imposes an additional overhead on tasks 
running under CICS/VS. Therefore, the system programmer is allowed to 
specify which transactions are protected and which are not. Recovery of 
messages after a catastrophic failure requires CICS/VS journaling and 
the system log. 

Nonprotected tasks should include those which only inquire about a 
data base or any other task for which double processing of the task 
following reentry of the task after a system failure would have no 
detrimental effect even if it occurred. 

The possibility of double processing arises because a task may 
complete prior to the failure, but be unable to issue a completion 
message to the logical unit. If a task performs only an inquiry of some 
data base record, reentering the request to re-create the reply after a 
system failure does not lead to invalid results. If, however, a task 
performs some update to a data base record, and the operator does not 
know whether processing was complete at the time of failure, reentering 
the original request may cause a double update of the data base record, 
thus leading to erroneous results. This would not happen if the task 
were declared as protected. 


Message Option Groups 

To control the message protection processing for a task executing on a 
VTAM-supported TCTTE, the system programmer may generate message option 
groups, which specify the manner in which CICS/VS DFHZCP is to treat the 
logical unit I/O requests for protection and recovery purposes. 

The message option group definitions should immediately follow the 
DFHPCT TYPE=INITIAL macro instruction. The OPTGRP operand of this macro 
instruction must be specified in order to make the options available for 
the task. The message option group name specified by the OPTGRP operand 
determines which option group is to be used for the task whose PCT entry 
references this group; this name also must appear as a symbol prefixed 
to the DFHPCT TYPE=OPTGRP macro instruction, whose parameters specify 
the desired characteristics (see below). 

The system programmer specifies any of the available parameters as 
either required or optional. The MSGPREQ operand defines the processing 
options and characteristics that are required for the task. All of the 
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parameters specified with this operand must be supported by the TCTTE on 
which the task executes; otherwise, the task initiation request is 
rejected. Alternatively, the MSGP0PT operand defines the processing 
options which the task uses only if the TCTTE on which it is running 
supports the function. If the function is not supported by the TCTTE, 
the task initiation request is not rejected, because the functions are 
optional by definition. There is no default value for either the 
MSGPREQ operand or the MSGPOPT operand; if omitted, no options are 
generated for the task. 

The following message group options can be specified with either the 
MSGPREQ operand or the MSGPOPT operand. See below for a discussion on 
the relationship between MSGPREQ and MSGPOPT. 

• PROTECT specifies that the task is protected, and implies the 
MSGINTEG parameter. CICS/VS also logs messages for protected 
tasks. PROTECT causes any write operation to a logical unit 
performed by a transaction to be deferred either until the CICS/VS 
application program issues a terminal wait request or until the 
task goes through a sync point or detaches. It ensures that the 
last message from a transaction (which confirms to the terminal 
operator that processing completed) is not delivered until the task 
has passed the commit point and is immune from backout if a system 
failure occurs. 

• MSGINTEG specifies that any output sent by CICS/VS to a logical 
unit on behalf of a task is sent with definite response protocol 
specified. 

• ONEWTE specifies that the transaction can perform one write only 
during its execution. DFHZCP sets an end bracket (EB) indicator on 
the first write processed for the task. Any subsequent write from 
the task is treated as an error by DFHZCP (because it would violate 
the bracket protocol), and the task is abnormally terminated. This 
parameter shortens the response time for simple, one-write 
transactions which run on TCTTEs that support the bracket protocol. 

Any of the above parameters can be specified singly or with other 
parameters. 

The CCONTR operand specifies that the application program may control 
the outbound chaining of request units. If this option is specified 
then the MSGPREQ/MSGPOPT option PROTECT must not be specified. If 
CCONTR=YES is specified ONEWTE means one chain (a chain is defined as 
the smallest recoverable unit), and not one DFHTC TYPE=WRITE. 

The user can specify optional and required task options when 
generating the program control table (PCT). At attach time, those 
options that are specified as optional execute if the logical unit 
permits them; however, if the logical unit does not permit an optional 
function, the task is attached, but that option is not performed. Those 
options that are specified as required execute if the logical unit 
permits them; however, if the logical unit does not permit a required 
function, the task is not attached. 


Emergency Restart and Message Logging 


Normally, the first entry on the log for a given protected task consists 
of a start-of-task indicator, the data sent by the originator of the 
task, and the inbound and outbound sequence numbers. If any change has 
been made to a protected resource (a data base record, for example), the 
original copy is also logged. 
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Once the task-originating data and start-of-task indicator have been 
logged, the task is considered in-flight. Any tasks in-flight at the 
time of failure are backed out by CICS/VS during emergency restart. The 
act of backing out means that all effects of the task are removed from 
the system, based on the records written to the system log. Naturally, 
messages already received or transmitted cannot be backed out, but 
operations such as updates on protected system resources which occurred 
during the course of the transaction can be backed out. 

The end of a protected task causes the CICS/VS to write the response 
message, the most recent inbound and outbound sequence numbers, and the 
end-of-task indicator to the system log. As soon as the end-of-task 
indicator has been logged, the task is no longer considered in-flight; 
it is now considered committed and is immune from backout. 

At this point, the deferred write becomes important. If the reply to 
the input message had been sent as soon as it was requested (that is, 
before the information was logged), a period of uncertainty would exist 
during which the task could still be backed out, because, as mentioned 
previously, a task is not immune from backout until the end of the task 
has been logged. Because VTAM and the NCP/VS are able to operate 
asynchronously from CICS/VS, the message could conceivably be delivered 
while CICS/VS is abnormally terminating. In this case, the task is 
backed out when emergency restart is performed, yet the terminal 
operator has already received a message confirming that the task 
completed. Because backing out the task removes the effects of the task 
from the system, the message sent to the terminal would be inconsistent 
with the status of the data bases. 

To guard against the above situation, the deferred write is employed. 
This ensures that any message created by a transaction that does not 
specify a wait is not physically transmitted to VTAM either until a 
terminal control wait is explicitly specified or until the task goes 
through sync point processing, thereby ensuring that all messages sent 
to the terminal are consistent with the status of the data bases. 


Emergency Restart 


During an emergency restart of CICS/VS, the information presented to 
CICS/VS concerning the system activity at the time of the failure 
comprises the records that appear on the system log. 

Any failure that occurs prior to the logging procedure is not 
detected, and CICS/VS assumes that the task-originating data was never 
received- This is the same as if the failure had occurred while the 
task-originating data was being sent from the logical unit to CICS/VS 
and was lost in the network because of the failure. 

From the data recorded on the system log, CICS/VS reconstructs the 
environment for any TCTTE that had either committed output pending or a 
message in-flight for a protected task at the time of failure. (The 
system log contains information about the terminal messages of protected 
tasks.) The environment reconstruction includes placing transaction- 
related information into the temporary storage message cache. 

The message cache is an area in temporary storage with the name 
DFHMxxxx, where xxxx is the four-character logical-unit identification. 
For a task failing in-flight, the message cache contains the data from 
the task-originating message, plus the transaction code, task number, 
and message sequence number. A flag byte indicates whether the data is 
for an inbound or an outbound message and if logged with or without an 
FMH. If the failure occurred after the task had passed the commit 
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point, the message cache contains the output message rather than the 
input message. If neither of these two conditions is present, the 
message cache is not created by emergency restart.. 

The system programmer may wish to write an application program to 
investigate the contents of the message cache following a system 
failure; if so, he should understand the format of the contents of the 
message cache. A discussion of the message cache can be found in the 
CICS/VS System/Application Design Guide . 


NONCATASTROPHIC FAILURES 


Environment reconstruction is not necessary following a noncatastrophic 
failure, because CICS/VS and the logical unit remain operational; 
message recovery is performed immediately after the failure is rectified 
by the node abnormal condition program (DFHZNAC) and, optionally, by the 
installation's node error program (NEP). Thus, DFHZNAC does not use the 
CICS/VS system log. 

The protected task and message integrity concepts are important 
because DFHZNAC uses the task's TI0A (which contains the data) in its 
recovery procedures. When errors are detected for tasks with message 
integrity, the TIOA is guaranteed to be available; for tasks without 
message integrity, the TIOA may have been released before the error was 
reported for processing. The actions taken by DFHZNAC for failing 
messages depends on the nature of the error and its circumstances; 
however, reliable information about a failing task is guaranteed only if 
the task has message integrity- 


Logical Unit I/O Error Handling (DFHZNAC/DFHZNEP) 

The node abnormal condition program (DFHZNAC) is a system program 
responsible for processing all abnormal situations associated with a 
logical unit. This is analagous to the situation under BTAM support in 
which terminal abnormal condition program (DFHTACP) is scheduled to 
resolve terminal errors. However, there is a difference between the 
DFHTACP/DFHTEP interface under BTAM and the functions of the VTAM 
equivalents, DFHZNAC and DFHZNEP. 

The implementation of terminal error processing for BTAM-supported 
terminals is such that any error is normally routed to the terminal 
abnormal condition program (DFHTACP). Depending on the type of error, 
DFHTACP issues messages, sets error flags, etc., and hands over control 
to the user-written terminal error program, DFHTEP, a dummy version of 
which is supplied by CICS/VS. After any necessary action by DFHTEP, 
control is handed back to DFHTACP via a DFHPC RETURN requests The 
interface between the node abnormal condition program (DFHZNAC) and node 
error program (DFHZNEP) is basically the same as that between DFHTACP 
and DFHTEP. The system programmer has the capability of providing, in 
table form, an interface module and a separate error routine for each 
specified transaction class. The function of the interface module, 
DFHZNEP, is to allow a particular transaction to have its own error 
processing procedure and determine which class of transaction is 
attached to the terminal and to link from DFHZNAC to the appropriate 
transaction-class error routine, identified via a macro used in 
assembling DFHZNEP. On completion of the action in the transaction- 
class error routine, control will be returned to DFHZNAC via DFHZNEP 
using the normal DFHPC RETURN request. 
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| The transaction class is identified to DFHZNEP via the NEPCLASS 

operand of the DFHPCT TYPE=ENTRY macro. The identifier is placed in the 
program control table for reference by the DFHZNEPI TYPE=ENTRY macro 
which associates the transaction class with a named user-written 
transaction-class error routine. For full details on the generation and 
| function of DFHZNEP, refer to the section in Chapter 4-3 on "User- 
j written Node Error Programs”. 

For logical units, all information concerning the processing state of 
the terminal is contained in the TCTTE and RPL. No accompanying line 
entry exists for a logical unit as is the case for a BTAM-supported 
terminals. Consequently, when a terminal error must be handled for a 
logical unit, the TCTTE itself is placed onto the system error queue. 

The action flags, set by DFHZNAC to assist the transaction-class 
error routines, are in TWAOPTL, which is in DFHZNAC *s transaction work 
area CTWA). 

The transaction-class error routine can interrogate TWAOPTL and 
modify the bit settings, if the user wants to modify DFHZNAC*s 
subsequent actions regarding the abnormal situation. If the user agrees 
with DFHZNAC*s proposed actions, TWAOPTL is left unaltered. 

In most cases, the transaction-class error routine can modify 
DFHZNAC*s proposed actions. The only time that DFHZNAC overrides the 
routine*s modification of TWAOPTL is when a logical unit is to be 
disconnected from CICS/VS; that is, when DFHZNAC determines that the 
abnormal situation requires that CICS/VS issues the VTAM CLSDST macro 
instruction for a logical unit. In such a case, the eventual action 
will depend on the two-byte system sense code received. If the system 
sense code is zero, the action specified by the transaction-class error 
routine will prevail. If the system sense code is other than zero, 
however, DFHZNAC will disconnect the terminal and abnormally terminate 
the task even if the transaction-class error routine tries to block such 
actions. 

Resetting of the task termination flag by the node error program is 
also ignored if a negative response has been sent to a logical unit or 
if DFHZEMW is to write an error message to the logical unit. 

When control is returned to DFHZNAC from DFHZNEP, DFHZNAC performs 
the actions specified in TWAOPTL (except when disconnecting logical 
units, as noted above), issuing messages and setting error codes, as 
necessary. 

DFHZNAC assumes that system sense codes are available upon receipt of 
an exception response from the logical unit. Thus, analysis is 
performed to determine the reason for the response. Decisions, such as 
which action flags to set and which requests are needed, are made based 
upon the system sense codes received. If sense information is not 
available, default action flags are set, and DFHZEMW is scheduled to 
send a negative response, if a response is outstanding, with an error 
message to the terminal. 

Appendix E lists the actions taken by DFHZNAC upon receipt of inbound 
system sense codes. 

Prior to executing the specified mandatory executive routines, 

DFHZNAC links to the user-written transaction-class error routine, via 
the interface module, DFHZNEP, in which action can be undertaken based 
upon user-defined criteria. 

The system programmer needs to code a transaction-class error routine 
only if he wishes to perform additional error processing beyond that 
performed by DFHZNAC. DFHZNAC gives control to the interface module. 
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DFHZNEP, and thus to the transaction-class error routine by issuing a 
DFHPC LINK request. DFHZNAC also passes the address of the TCTTE 
concerned, so that the system programmer can specify further recovery 
actions based on the processing state of the logical unit. When the 
transaction-class error routine has performed its functions, control is 
returned to DFHZNAC via DFHZNEP by issuing a DFHPC RETURN request. 

Upon entry to DFHZNEP and the transaction-class error routine, the 
following fields are available to the system programmer: 

• The error code generated by DFHZNAC. The error codes are indicated 
in the discussion on the node error program and in Appendix E. The 
error code is located at TWAEC. 

• The action flags set by DFHZNAC. These flags are depicted in 
Figure 5.2 and are defined in the section on the node error program 
and in Appendix E,. The collective field name for these flags is 
TWAOPTL. 

• The address (TWATCTA) of the TCTTE. 

• The terminal name, at TWANID. 

• The sense codes received by DFHZNAC: 

TWASRI and TWASR2, system sense codes. 

TWAUR1 and TWAUR2, user sense codes. 

Linkage to DFHZNEP is provided by CICS/VS. Fields in the TWA are 
defined in the copy section DFHVTWA, which provides a DSECT of the node 
abnormal condition program’s TWA. 
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Byte 

Action Code Options 



Action-code 

Label 

Description 



TWAOAF 

Print action flags 

(XW) 


TWAORPL 

Print RPL 

(X'40') 

TWAOPT1 

TWAOTCTE 

Print TCTTE 

(X'20') 


TWAOTIOA 

Print TIOA 

<X'10') 


TWAOBIND 

Print bind area 

{X'081 


TWAOAS 

Abort VTAM SEND 

(X'80') 

TWA0PT2 

TWAOAR 

Abort VTAM RECEIVE 

(X'40'l 

TWAOAT 

ABEND task 

(X'20') 


TWAOASM 

SIMLOGON required 

(X'02') 

TWAOPT3 

j TWAOOS 
TWAOCN 

Keep node out of service 
Break connection 

(X'02') 
(X'01') 


Explanation of the flags follows: 

The first five labels (TWAOAF, TWAORPL, TWAOTCTE, TWAOTIOA, and TWAOBIND) 
are principally debugging aids for the user. NACP writes the desired information to the 
CSML log if its accompanying bit is set. 


The next four are task related (TWAOAS, TWAOAR, TWAOAT, and TWAOASM). If the 
task is to be abnormally terminated, sends and receives are purged. 


Note: If the request is to be retried and if the break connection action flag is not on {that is, 
if TWAOCN if off), TWAOAS and/or TWAOAR must be off as well as TWAOAT. 

The last two are node related (TWAOOS, TWAOCN). If TWAOCN is set, the task is abnormally 
terminated and communication with node is lost. 


Setting TWAOOS indicates no further processing is to be done for this node. The node is logically 
out of service. 


| Figure 5.2. DFHZNAC Action-Code Bytes and Available Options 


If DFHZNAC is scheduled because of the receipt of an exception 
response, the sense information in the TCTTE is available to DFHZNAC and 
DFHZNEP to determine any necessary actions. 

If DFHZNAC is scheduled because of loss of the connection between 
CICS/VS and a logical unit, DFHZNAC abnormally terminates any 
transaction in progress at the time of the failure. DFHZNEP and 
transaction-class error routine analysis and processing are permitted, 
but message retry should not be attempted. 

The DFHZNAC error message is sent to the master-terminal log prior to 
linking to DFHZNEP. User-written messages may also be sent to the log 
using the transient data facility. To write the installation's own 
messages, the system programmer must code the DFHTD TYPE=PUT macro 
instruction directly into the transaction-class error routine. 
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The CICS/VS terminal control macro enables the system programmer to 
issue VTAM indicators in the transaction-class error routine. The 
available functions are explained in "Modifying the TCT” in Chapter 6.5 
of this manual. 


DFHZNAC Logging Facility 


To aid in retrieving related information (that is TIOA, CSA, TCA) about 
a problem in a real time environment, a logging facility is available in 
DFHZNAC. 

For example, if during the processing day a logical unit sends an 
exception response to data sent from the host, the TIOA can be examined 
to locate the problem. 

DFHZNEP can pass the address of the TIOA plus a desired length (not 
exceeding 220 bytes) in DFHZNAC* s TWA. On return to DFHZNAC, the data 
is logged to the CSMT or CSTL transient data log for future inspection. 

TWA fields ares 


Name Length Content 

TWANLD 4 bytes address of data to be logged 

TWANDLDL 2 bytes desired length of data to be logged 

Note : All data in excess of 220 bytes is not logged. 


CICS/VS TERMINAL CONTROL 


The terminal control macro instruction provides capabilities intended 
only for CICS/VS management modules and for the system programmer. The 
system programmer may use these macro instructions to: 

• Scan the terminal control table (CTYPE=LOCATE) 

• Change the status of a logical unit (CTYPE=STATUS) 

• Issue a VTAM indicator (CTYPE=COMMAND) 

• Check the outcome of any of the above operations (CYPE=CHECK) 

For details of these facilities, refer to "Modifying the Terminal 
Control Table" in Chapter 6.5 of this manual. 

TRANSACTION OPTIONS 


When specifying the PCT entries for transactions (through the DFHPCT 
TYPE=ENTRY macro instruction), the system programmer may: 

• Restrict certain transactions to run only for logical units or for 
BTAM-supported terminals 

• Specify transaction options related to message journaling 
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• Specify I/O processing options 

• Control message protection options 

The DVSUPRT operand specifies that certain transactions are permitted 
to execute only for a terminal or for a logical unit. The VTAM 
parameter of this operand restricts the transaction to being executable 
only on a VTAM TCTTE. The NONV parameter restricts the transaction to 
being executable only on a non-VTAM TCTTE (for example, a BTAM, BSAM, or 
a GAM TCTTE). The ALL parameter specifies that the transaction may 
execute on any TCTTE; ALL is the default value for this operand. 

The MSGJRNL operand specifies whether or not automatic journaling of 
messages is to be performed by the terminal control program for 
particular transactions. Message journaling may be requested for either 
input or output messages, or both. 

If the MSGJRNL operand is specified, the JFILEID operand must also be 
specified in order to indicate where the automatic journaling 
information is to be recorded. The SYSTEM option indicates that the 
information for messages associated with logical units is to be recorded 
on the system log. To record the information on a particular 
installation journal data set instead of on the system log, the journal 
identification must be specified; this identification can be any value 
in the range 2 through 99, inclusive. If NO is specified, message 
journaling is not performed; NO is the default value for this operand. 

If the automatic journaling option is selected, the system programmer 
must ensure that the relevant journal control program and journal 
control table parameters are specified to support the DFHTCP automatic 
journaling requests. 

The I/O processing options (DELAY and IMMED) are discussed in "Output 
Services" earlier in this chapter. 

The message option groups specify the manner in which CICS/VS DFHZCP 
is to treat the logical unit I/O messages for protection and recovery 
purposes; they are discussed earlier in this chapter. 


AUTOMATIC TASK INITIATION (ATI) 

Before CICS/VS attempts automatic task initiation (ATI) for a logical 
unit, it checks whether ATI is allowed for the particular logical unit. 
To permit ATI, the TCTTE that represents the logical unit must be in 
either the TRANSCEIVE or RECEIVE state, and must also be in service. 
These states are specified in the TRMSTAT operand in DFHTCT 
TYPE=TERMINAL. 

A TCTTE may be in service or out of service independent of whether or 
not it is connected to CICS/VS. If a logical unit TCTTE is in service 
but not connected when ATI is to be performed, CICS/VS requests a VTAM 
simulated logon to establish connection. For example, a simulated logon 
must be performed for an in-service logical unit in receive state. 

The system programmer must ensure that the TCTTE for which ATI is 
requested is either in transceive or receive state, and is in service. 
These parameters may be specified when the terminal control table is 
generated (through the DFHTCT macro instruction). They may also be 
specified by the DFHTC CTYPE=STATUS macro instruction of the terminal 
control interface to enable dynamic status changes. Refer to Chapter 
6.5 for further details of the DFHTC CTYPE-STATUS macro. 
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| USER EXIT ROUTINES FOR CICS/VS VTAM TERMINAL CONTROL 

CICS/VS VTAM logical unit support provides the system programmer with 
the option of coding a user exit routine, which is to be given control 
at defined points during the processing of a request by CICS/VS VTAM 
terminal control. 

To include a user exit routine in CICS/VS VTAM terminal control, the 
required code and associated label must be placed into the CICS/VS 
source library member (book), DFHTZEXT, prior to generating and 
| assembling the CICS/VS DFHZCB module. Only one exit routine is 
j supported for each CICS/VS VTAM terminal control module; if more than 
| one CICS/VS VTAM terminal control module is generated, the system 
programmer is permitted to code a different exit routine (with a 
distinguishing label) for each. The code for each routine must appear 
in DFHTZEXT, preceded by its reference label. 

| When generating a DFHZCB module, the required exit is indicated by 
j specifying its label as the parameter of the exit operands (ZINPUT and 
j ZOUTPUT) of the DFHSG PROGRAM=TCP macro instruction. 

I Note : The terminal control program for CICS/VS Version 1 Release 4 
j consists of six modules. Only DFHZCB contains user-exit code. 

Because these exit routines are executed as an extension of a CICS/VS 
management module, the designer of the exit routine must be fully aware 
of the conventions and restrictions that apply in such an environment. 
The exit routine must be coded in assembler language and be at least 
serially reusable. Requests for CICS/VS services are forbidden in the 
exit routine. Issuing a wait within a management module, which is 
servicing a request that is executing under a non-user TCA, can 
seriously degrade system performance, and unexpected task switches from 
within management modules may lead to unpredictable system damage. 

Control is given to the specified exit routine at each of the 
following three points every time a request referring to a VTAM- 
supported TCTTE is serviced: 


Label Processing State 

ZATTACH Prior to a task attach. 


ZOUTPUT Prior to issuing the logical message in the DFHZCP send 
subroutine; no chaining requirements have yet been 
determined. 

ZINPUT After the entire logical message is received by CICS/VS. 


The conditions at entry to each exit are: 
Exit-Routine Register Contents 


ZATTACH 

14 

ZOUTPUT 

13 

ZINPUT 

12 


11 


10 


9 

8 

7 

6-2 

0,1,15 


Return address 

CSA address 

TCA address 

TCT prefix address 

TCTTE being processed 

RPL allocated to TCTTE 

TIOA address 

DFHZCP base register 

Reserved 

Available to user exit routines 
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For ZATTACH, register 8 points to the TIOA containing the 
transaction-originating data. 

For ZINPUT, the exit routine should not rely on the data address or 
length in the RPL addressed by register 9, but should use the TIOA 
addressed by register 8 and the message length in TIOATDL. The exit 
routine receives control only once for each logical message received by 
CICS/VS; because if the message is too large to fit into the CICS/VS I/O 
area, an additional receive-specific is required to obtain the remainder 
of the message from VTAM. (See "Input Services" earlier in this chapter 
for further information.) Control is given to the user exit routine 
only after the complete message has been received by CICS/VS from VTAM. 

CICS/VS DFHZCP generates linkage to the appropriate exit by the 
sequence: 


L 14,=V(label) 

BALR 14,14 

If no exit routines are supplied, CICS/VS does not generate any of 
the linkages, and the DFHTZEXT codes are not included in DFHZCP. 


BMS SERVICES 

Mapping support for logical units is generated by specifying the 
required parameter of the BMSDEV operand in the DFHSG PROGRAM=BMS macro 
instruction. If these parameters are not specified, BMS routines for 
the relevant logical units are not included. The batch data interchange 
program (DFHSG PROGRAM=DIP) must be generated if BMS routines are 
required for batch logical units. 

The BMSDEV operand is used to specify all non-3270 devices for which 
BMS support is to be generated. If the operand is not specified, 
support for all devices is assumed by default. The generation of the 
routines which support 3270 mapping is controlled through the existing 
MAP3270 operand. 

When generating BMS functions into the system, the system programmer 
is provided with considerable flexibility for tailoring the amount of 
support included. By choosing only those functions required for a 
particular installation, the working set requirements for a system can 
be significantly reduced. 

The ROUTING operand of the DFHSG PROGRAM=BMS is available to provide 
routing facilities for certain logical units. The CICS/VS temporary 
storage management module (DFHTSP) is required to support the routing 
function. The system programmer must generate the DFHSG PROGRAM=TSP 
macro instruction if the routing facility is specified. 


Mapping Individual Records and Entire Chains 

In order to map each card or line of a request unit (RU) separately, the 
user should specify logical record presentation for the transaction (in 
the LOGREC operand of DFHPCT TYPE=ENTRY) for logical units for which 
logical record presentation and chain assembly apply. Otherwise, all 
records after the first in the RU will be bypassed. 

In order to map an entire chain, potentially consisting of more than 
one RU, the user should specify the CHNASSY operand in the DFHTCT 
TYPE=TERMINAL macro for the logical unit. 
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STATISTICS 


Existing statistics are maintained for each logical unit. The following 
statistics are incremented by one whenever the indicated condition 
occurs: 


Statistic 
Write count 

Read count 


Error count 


Error count 


Condition 

VTAM SEND is accepted by a logical unit on behalf of a 
terminal for part of a chained output data message. 

VTAM RECEIVE is completed for an input data request sent 
by a logical unit on behalf of a terminal. If more than 
one RECEIVE was necessary for CICS/VS to obtain the 
complete request unit from VTAM, the read count is still 
only incremented by one. 

VTAM SEND is rejected by a logical unit on behalf of a 
terminal for any part of an output data message. 

An exception response is received by CICS/VS for any 
reason. 


Statistics are kept for evaluating the size of the receive-any RPL 
pool. (See "Input Services" earlier in this chapter for information 
about the RPL pool.) Every time DFHZCP is dispatched, it scans the pool 
of RPLs and counts the number of RPLs that were posted complete. DFHZCP 
records the maximum value of this count and increments a second counter 
each time this maximum is reached; every time a new maximum is recorded, 
the second counter is reset to one. This statistic is printed along 
with any request that produces the existing terminal statistics; it 
gives the maximum value achieved and the number of times it was reached. 

In a system in which the maximum value is less than the size of the 
RPL pool during the course of a normal day, the number of RPLs specified 
for the pool could be reduced to the maximum value with no effect on 
system performance. Conversely, if the maximum value reaches the size 
of the RPL pool many times during the day, this may indicate a 
bottleneck in the system that might be causing unnecessary use of the 
pageable buffer area by VTAM; this situation could be improved by 
increasing the RPL pool size. 

A good trial value for the size of the RPL pool is the maximum task 
value which is specified by the MXT operand of the DFHSIT TYPE=CSECT 
macro instruction. The value should then be reduced in accordance with 
the statistics recorded for peak activity. Too high a value may result 
in unnecessary page faulting within the RPL pool. 

Another statistic keeps a count of the number of times that VTAM 
temporarily rejects a CICS/VS request because a short-on-storage 
condition exists in VTAM. This helps the user to monitor any system 
bottleneck that may arise because insufficient buffer space was 
allocated during VTAM definition. 


MESSAGE SWITCHING 

When a terminal list table is built for use with message switching, each 
entry in the table contains logical unit identifications. The TRMIDNT 
operand of the DFHTLT TYPE=ENTRY macro instruction is used to specify 
the identification of the logical unit to be used to direct the message. 
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i Chapter 5.3. The CICS/OS/VS TCAM Interface 


This chapter describes the use of TCAM under CICS/OS/VS. The following 
topics are discussed: 

• The use of TCAM in an SNA network, with reference to protocol 
management, FMH processing, and error processing. 

• The TCAM application program interface, including information on 
the process control block and the TPROCESS control block. 

• The interface between TCAM and CICS/OS/VS, which includes 
information on terminal entries (TCTTEs) and line entries (TCTLEs) 
data flow,, logic flow, the terminal error program, message routing, 
pooling, and segment processing. 

• Device considerations, which deals with message formats for devices 
(in particular, the 2260 and 3270) being used on a TCAM line. 

• User exits, which gives information on the three TCAM exits which 
may be specified in the terminal control program. 

• The process of starting up, restarting after an abend, and 
terminating TCAM under CICS/OS/VS. 

• The TCAM message control program and its relationship to the 
application program (in this case, CICS/OS/VS). 

In addition, two sample TCAM message control programs for use in an 
SNA network can be found in Appendix F. 

The majority of independent teleprocessing applications require a 
dedicated network. The telecommunications access method (TCAM) permits 
multiple applications to share a single network, resulting in more 
efficient use of terminals and lines. The CICS/OS/VS/TCAM interface 
enables CICS/OS/VS to run as an application program under TCAM. 

TCAM is an access method that may be used alone or in combination 
with other access methods (BTAM, BSAM, VTAM, and BGAM)• 

One practical use of the CICS/OS/VS/TCAM Interface is to run a 
"production" CICS/OS/VS system in one region and a "test" CICS/OS/VS 
system in another. Running in separate regions, the applications are 
protected from one another. Operating under TCAM, terminals and lines 
can be shared by the two CICS/OS/VS applications. Other TCAM 
applications such as the time sharing option (TSO) can also be running 
concurrently. 

In most cases, CICS/OS/VS user tasks that run under BTAM can run 
under TCAM without modification to the task code. This assumes that the 
user has properly designed and coded his TCAM message control program 
(MCP)• Modifications to his CICS/OS/VS terminal error program (DFHTEP) 
are required to take advantage of the new error codes used in the 
CICS/OS/VS/TCAM Interface. 

There are basic differences between TCAM and BTAM design methods. 
CICS/OS/VS was designed to operate in the BTAM environment. The 
CICS/OS/VS/TCAM Interface, although resolving most of the differences, 
must impose some restrictions when CICS/OS/VS is run in a TCAM 
environment. These restrictions as well as some of the ramifications of 
selecting various user options are addressed in this section. Also 
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described are the user facilities available and how the user implements 
and operates the system through the interface. 


CICS/OS/VS WITH TCAM SNA 

TCAM can be used to provide an SNA network without the use of VTAM. The 
CICS/OS/VS/TCAM interface has an enhanced data stream support which 
enables a suitably written TCAM message control program (MCP) to control 
the SNA session,. The TCAMFET= SNA operand in DFHTCT TYPE=LINE allows 
TCTTEs to be specified for SNA devices. The user must be prepared to 
write an appropriate TCAM SNA message control program to complement the 
CICS/VS support and the SNA devices attached to the system. Sample TCAM 
SNA MCPs are provided in Appendix F-. 

The support provided by TCAM for SNA devices running under CICS/VS is 
a data steam support. Both the SNA character string (SCS) and the 3270 
data streams are supported. 

In order to understand how CICS/VS works with TCAM in an SNA 
environment, it is important to understand the TCAM SNA structure. The 
device message handler (DMH) is the logical unit in SNA terms. All data 
flow control (DFC), session startup and takedown, and response handling 
are provided in the DMH. There is no CICS/VS control of these SNA 
functions and the application programmer need not be concerned with 
these functions. For a more detailed discussion of the TCAM SNA 
functions provided, refer to the OS/VS TCAM System Programmers Guide . 


PROTOCOL MANAGEMENT 


Many different protocols may exist in an SNA network. The various 
protocols are established on a session basis by using the bind image. 

The decision on which protocols to use with which SNA session belongs to 
the system programmer, who should understand the requirements of the 
installations application programs before deciding on a specific 
protocol. 

Some of the more common of these SNA protocols are: bracket, half¬ 
duplex flip-flop (HDX-FF), and half-duplex contention (HDX-CON). The 
enforcement of these protocols is a function of the DMH. 

There are two ways of performing protocol management in a 
CICS/OS/VS/TCAM system: 

• device message handler control 

• transaction control 

These methods are discussed below. 


Device Message Handler Control 

This type of protocol management is used when the transaction wishes to 
be completely unaware of the device with which it is communicating. 
Although the communication control bytes are passed between CICS/VS and 
TCAM, they are not used to control the SNA session. All the protocol 
control is provided in the DMH. The appearance at the outboard LU is at 
the option of the system programmer (MH writer) instead of the 
application programmer. - 
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Transaction Control 


This method of protocol management is one in which the transaction 
exhibits control over the protocol. The SNA session should be bound 
with a protocol of HDX-FF with brackets when running this type of 
management. The second sample MCP provided in Appendix F is an example 
of a transaction controlled message handler (MH). 

When running with transaction control over the protocol, the 
communication control byte (CCB) is used to relay information from the 
transaction to the DMH. For example: 

• DFHTC TYPE=WRITE,LAST should be used to end a transaction. Issuing 
this macro causes an indicator to be set in the CCB requesting that 
the DMH send an end-of-bracket (EB). 

• DFHTC T YPE= CONVERSE should be used when terminal input is required 
after a WRITE. This macro causes an indicator to be set in the CCB 
requesting that the DMH send the CHANGE DIRECTION indicator to the 
device. 

• DFHTC TYPE=DISCONNECT should be used to end the logical unit 
session. This macro causes an indicator to be set in the CCB 
requesting that the DMH terminate the LU-LU session (that is, issue 
the IEDHALT macro). 


FUNCTION MANAGEMENT HEADER (FMH) PROCESSING 


The FMH enables function management information to be directed to unique 
components within the logical unit. The FMH also provides a mechanism 
in which control information relating to the operation of those 
components may be passed. FMH processing is a bind time option (that 
is, a bind parameter is available to indicate whether an FMH may or may 
not appear in the LU to LU session). 

CICS/OS/VS/TCAM SNA provides support for the logical device code 
(LDC) which is transmitted in the FMH to the logical unit. The LDC 
provides for the communication of the logical disposition of output to 
the logical unit and can represent any meaning which is useful to the 
purpose of the installation. 

There are two ways that FMH handling can be provided. The first is 
for the transaction to provide the FMH as part of the data passed to 
TCAM by issuing a DFHTC TYPE=WRITE,FMH=YES macro. An indicator is set 
in the CCB so that the DMH can set the "FMH included" indicator in the 
request handler (RH) by using the IEDRH macro. On input, the DMH should 
interrogate the RH (using the IEDRH macro) to determine whether an FMH 
is included in the data. If the FMH indicator is set in the RH, the DMH 
should set the FMH indicator in the CCB relating to the transaction in 
which the input data contains an FMH. 

A second method of FMH handling is to provide the entire function in 
the DMH. The DMH should remove the FMH before passing the input data to 
the transaction and insert the necessary FMH into the output data. In 
order for the DMH to build the correct FMH for output, some form of 
private interface must be established between the system programmer and 
the application programmer. For example, the first byte of data 
following the CCB can contain unique values which request specific FMH 
functions such as "begin data set", "erase record", and so on. 
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It is recommended that if FMH processing is required, the transaction 
Cor preferably BMS) be used to provide the appropriate FMH. 


BATCH PROCESSING 


When running a batch logical unit, an optional consideration facing the 
system programmer is how to get the transaction identification to 
CICS/VS on the "begin data set" condition- The alternative methods are 
discussed below. 

The first method is for the DMH to recognize the "begin data set" 
condition by interrogating the FMH and by editing the transaction ID 
into the input data. This method is demonstrated in the sample MCPs 
provided in Appendix F. 

The second method of providing the transaction ID is for the DMH to 
concatenate the "begin data set" chain with the first chain of the data 
set by using the SETEOM macro. This method requires that the first 
chain of the data set contains the transaction ID. Alternatively, the 
transaction ID could be set with the TCTTE beforehand by means of a 
permanent TRANSID or by using DFHPC TYPE=RETURN,TRANSID=xxx. 


ERROR PROCESSING FOR BATCH LOGICAL UNITS 


During batch processing with a logical unit, there are certain logical 
errors from which the DMH cannot recover (for example, data set overflow 
or incorrect data set name). A transaction can be provided to handle 
these error conditions. If the transaction builds the data set on the 
TCAM queue and ends before the data set is transmitted, an error 
transaction should be created. The DMH should generate the appropriate 
error message or pass the SNA sense bytes to this error transaction, 
which then handles the error condition. If the transaction which builds 
the data set remains active throughout the transmission of the data set 
to the device, the transaction could be coded to recognize the error 
indicators passed to it from the DMH, rather than creating a separate 
error transaction. 


ERROR PROCESSING 


All error conditions, other than logical errors, are handled by the DMH. 
The QS/VS TCAM System Programmer’s Guide contains a discussion on the 
handling of the various sense codes returned by SNA devices. The 
transaction is not involved in error processing and recovery. 


TCAM APPLICATION PROGRAM INTERFACE 


The TCAM application program interface is a portion of the TCAM message 
control program (MCP). It consists of two types of control blocks, the 
process control block (PCB) and the TPROCESS block. 

The PCB defines the application program interface of a 
partition/region in the system using TCAM. Its purpose is to control 
communication and storage protection across partition/region boundaries. 
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It also defines the user-written message handler (MH) responsible for 
processing messages to and from the application program. Because a PCB 
is required for each application program running with the MCP, a PCB is 
required to define the CICS/OS/VS application program. 

The TPROCESS control block controls communication to and from the 
application program. A separate block is required for both input and 
output to the application program. A TPROCESS block is required for 
each input queue to CICS/OS/VS and for each output queue from 
CICS/OS/VS. In CICS/OS/VS, there are corresponding terminal control 
table line entries (TCTLEs) for each input queue and for each output 
queue (that is, for each TPROCESS block). 

DD cards (such as those shown in Figure 5.3-1) are used to correlate 
the TCAM control blocks with the CICS/OS/VS control blocks. The 
CICS/OS/VS terminal control table contains the DCB. The DDNAME 
specified in the terminal control table macro instruction (DFHTCT 
TYPE=SDSCI,DDNAME=name) names the DD card. In the DD card, the QNAME 
field names the TCAM TPROCESS block. 

No exceptions are required for CICS/OS/VS to the TCAM application 
program interface just described. For additional information, refer to 
the OS/VS TCAM Application Programmers Guide . 


MCP (TCAM) MPP (CICS/OS/VS) 



Figure 5.3-1. DD Card Correlation of TCAM and CICS/OS/VS Control Blocks 


CICS/OS/VS/TCAM INTERFACE 

A TCAM input process queue is considered to be a "line" to CICS/OS/VS. 
For each input process queue there is a CICS/OS/VS terminal control 
table line entry (TCTLE). Note that TCAM requires the application 
program (CICS/OS/VS) to have a DCB for each TPROCESS block? separate 
TPROCESS blocks are required for input to and output from the 
application program. Therefore, each TCAM output process queue is also 
considered to be a line and has a corresponding CICS/VS TCTLE. Each 
TCTLE references its own DCB generated by the DFHTCT TYPE=SDSCI macro 
instruction in CICS/VS. 

The CICS/OS/VS terminal control table terminal entries (TCTTEs) 
define the terminals associated with a particular line entry (TCTLE). 

For each physical terminal communicating with CICS/OS/VS through TCAM, a 
corresponding TCTTE containing the terminal identification must be 
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associated with a TCTLE. Duplicating individual TCTTEs for both the 
input TCTLE and the output TCTLE is avoided by attaching a single, 
special TCTTE to the input TCTLE and attaching all the individual TCTTEs 
to the output TCTLE. Although attached to the output TCTLE, they are 
used for both input and output processing. 

Each input record from TCAM must contain the source terminal 
identification (OPTCD=W specified in the CICS/VS DFHTCT TYPE=SDSCI macro 
instruction). Using this identification as a search argument, the 
corresponding TCTTE can be located by CICS/OS/VS by comparing against 
the NETNAME value for each TCTTE. 

Using the POOL feature (POOL=YES of the DFHTCT TYPE=LINE macro 
instruction), it is possible to establish a pool of common TCTTEs on the 
output TCTLE that do not contain terminal identifiers. As required, 
terminal identifiers are assigned to the TCTTEs or removed from 
association with the TCTTEs. This POOL feature necessarily imposes a 
number of restrictions and should be thoroughly understood before being 
implemented. For additional information, see the discussion of the POOL 
operand in the section on "Line Pool Specifications". 


DATA FORMAT 


When TCAM is specified, CICS/OS/VS assumes that the user transaction 
data passed to it from the TCAM queue is in the proper format to be 
passed directly to the user task. Except for the removal of the source 
terminal identification and the two-byte CCB if on a TCAM SNA line, 
CICS/OS/VS does not alter the data it receives. It is the user’s 
responsibility (through his MCP) to properly prepare the data, such as 
translating to EBCDIC, removing FMHs, stripping line control characters, 
and deblocking. The user may optionally bypass the CICS/OS/VS routine 
that removes the source terminal identification by returning from the 
user-written input exit (XTCMIN) in TCP with a displacement of zero 
bytes. 

Similarly, CICS/OS/VS assumes that the user transaction data passed 
to it for TCAM has been properly formatted for direct placement on the 
TCAM output process queue. Except for the insertion of the destination 
identification, the CCB, and the data-stream control characters, 
CICS/OS/VS does not alter the data it receives. It is the user’s 
responsibility (through his MCP) to properly prepare the data for the 
destination terminal, such as by translating and inserting line control 
characters. 

Optionally, BMS can be used with TCAM to prepare the input data for 
the user task and the output data for the specific terminal type. When 
BMS is required with TCAM, the TRMTYPE operand in DFHTCT TYPE=LINE or ir* 
DFHTCT TYPE=TERMINAL must indicate the specific terminal type for 3270 
and 2260 data streams. TRMTYPE=TCAM can be used to obtain EBCDIC data 
stream support. For BMS support within SNA, the TCAMFET= SNA and 
SESTYPE= operands must also be specified in DFHTCT TYPE=LINE and in 
DFHTCT TYPE=TERMINAL, respectively. 


LOGIC FLOW 

The following is a generalized description of the sequence of events 
that occurs in CICS/OS/VS when interfacing with TCAM. 
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INPUT STEP 
A 

B 

C 


D 


F 


G 


H 


ACTION 

TCAM notifies CICS/OS/VS that it has data for a 
particular input TCTLE by posting its ECB. 

CICS/OS/VS gets a TIOA and attaches it to the 
special input TCTTE in the TCTLE. 

CICS/OS/VS issues a READ to TCAM which results in 
TCAM passing the data over the partition or 
region boundaries to the CICS/OS/VS TIOA. 

CICS/OS/VS indicates at this time that it has 
data to process. (See Figure 5.3-2) 

The input TCTLE points to the corresponding output 
TCTLE in response to the OUTQ specification of 
the DFHTCT TYPE=LINE macro instruction. 

The individual TCTTEs on the output TCTLE are 
searched for a matching source terminal netname. 

If POOL=YES has been specified, a free TCTTE is 
assigned to this source terminal identification. 
(See Figure 5.3-3). 

If an input user exit (XTCMIN) has been specified, 
CICS/OS/VS links to the user exit routine where 
the user may edit input data prior to passing it 
to a task (see XTCMIN in "TCAM User Exits".) 

If no exit has been specified, CICS/OS/VS removes 
the eight-byte source terminal identification field 
inserted by TCAM. For SNA devices, the input 
communication control byte (CCB) is removed. 

No other editing .of the data is performed. 

A check is made to determine whether a task is 
attached to the individual TCTTE. If not, go to H. 

If a task is attached, a check is made to see if 
the task has issued a READ. If a READ request 
exists, go to Step J. If not, CICS/OS/VS halts the 
processing of data in the queue until the TCTTE 
is available or the attached task issues a READ. 

CICS/OS/VS attaches the appropriate task. A 
user exit is available prior to the actual attach. 
(See XATTACH in "TCAM User Exits.") 

If the task could not be attached (for example, 
a "maximum task" or "short on storage" 
condition exists), CICS/OS/VS remembers it has data 
to process and exits DFHTCP. 


The CICS/OS/VS TCAM Interface 
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INPUT STEP 
I 

J 


ACTION 

Once a task is attached, CICS/OS/VS stores the 
TCAM segment identifier in the TCTTE (if segment 
processing was specified by including the C 
parameter in the OPTCD operand of the DFHTCT 
TYPE=SDSCI macro instruction). 

CICS/OS/VS passes control to the attached task. 


TCAM input 
process queue 



TIOA 


Figure 5.3-2. CICS/OS/VS Issues A TCAM Read 
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OUTPUT STEP 
A 

B 

C 


D 



P 


ACTION 

The user issues a WRITE request in his 
application program* 

The TCP terminal scan recognizes the WRITE 
request. 

CICS/OS/VS checks whether an output user 
exit (XTCMOUT) has been specified. If specified, 
CICS/OS/VS links to the user exit routine, 
where the user may edit his output data prior 
to passing it to TCAM. (See the discussion of 
XTCMOUT in "TCAM User Exits.") 

CICS/OS/VS checks the four-byte TCTTE field 
TCTTEDES for a destination saved as a result 
of DEST=NAME or DEST=YES having been specified 
in the DFHTC TYPE=WRITE macro instruction. 

If present, CICS/OS/VS inserts it in the eight-byte 
destination field and left justifies the field, 
padding blanks to the right. Otherwise, 

CICS/OS/VS moves the source terminal netname 
from the TCTTE to the destination field. 

CICS/OS/VS moves the communication control 
byte (or bytes if TCAM SNA) into the ninth byte 
(ninth and tenth bytes if TCAM SNA) of the TCAM 
work area. See "TCAM Device Considerations." 

CICS/OS/VS issues a TCAM WRITE to transfer the 
data to TCAM. 


G After checking for successful completion of the 

WRITE to TCAM,CICS/OS/VS posts the user task 
"dispatchable" if a task is still attached to the 
TCTTE. Otherwise, CICS/OS/VS frees the TCTTE 
for a new task. 
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TCAM input 
process queue 



Figure 5.3-3. After TCAM Read, CICS/OS/VS Attaches TIOA To 
Corresponding TCTTE 


TERMINAL ERROR PROGRAM 


The CICS/OS/VS/TCAM Interface implementation has resulted in the 
expansion of the CICS/OS/VS terminal error program (DFHTEP) error codes 
and conditions. The following errors and actions unique to TCAM and 
which should be considered in DFHTEP are: 


Error Code 


Condition 


Action 


’ 87*(TCEMUI) 


X * 9F *(TCEMIDR) 


Unsolicited input 

Terminal "Receive Only" 
Terminal "Out of Service" 
Task has not issued a read 
No available TCTTE from 
pool 


a 

a, b 

(no default) 
(no default) 


TCAM has issued an invalid c 

destination return code to 
CICS/OS/VS. 


where: 

a = Release TCAM TIOA (X'80* at TCTLEECB+2) 
b = Terminal out of service (X* 08'* at TCTLEECB+1) 
c = abend transaction (X*04 f at TCTLEECB+1) 
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MESSAGE ROUTING 


The DEST operand of the DFHTC TYPE=WRITE macro instruction can be used 
to route an output message to a destination defined by the user in the 
TCAM MCP. This operand can be used to send a message to a destination 
other than the source terminal (such as to another terminal, a list of 
terminals, or another application program). 

If DEST=name is specified, "name" is stored in the four-byte field 
TCTTEDES. If DEST=YES is specified, it is the user's responsibility to 
have placed the destination name in TCTTEDES prior to issuing the WRITE 
macro instruction* 

CICS/OS/VS moves the data from TCTTEDES into the destination 
identification field prior to placing the data on the TCAM output 
process queue. The user may bypass the CICS/OS/VS routine that inserts 
the destination field by taking the XTCMOUT user exit and returning to 
CICS/OS/VS from the exit with a displacement of zero. In this case, the 
user must ensure that the TCAM header is properly formatted for output. 

If the DEST operand is omitted, CICS/OS/VS inserts the source 
terminal NETNAME from the TCTTE into the destination identification 
field. 


SEGMENT PROCESSING 

The CICS/OS/VS/TCAM Interface supports TCAM segment processing, except 
when BMS is used. It permits segments of a message to be forwarded to 
CICS/OS/VS rather than waiting for the entire message to be received. 

If the user specifies segment processing (by including the parameter "C" 
in the OPTCD operand of the DFHTCT TYPE=SDSCI macro instruction), 
CICS/OS/VS passes the segment to the user and places the one-byte 
position field control byte in the TCTTE field labeled TCTTETCM. 
Similarly, on output, the user must supply the control byte in TCTTETCM 
for CICS/OS/VS to pass to TCAM. If multiple terminals have been defined 
for one output line (that is, multiple terminals related to one TPROCESS 
queue), the user must ensure that an entire message is passed to TCAM 
for a specific destination before putting the first segment for another 
destination on the queue. In other words, an error is returned to the 
user if a PUT first segment to destination A is followed by a PUT first 
segment to destination B. For additional information on segment 
processing, refer to the discussion of the OPTCD operand of the 
application input and output DCB in the OS/VS TCAM Application 
Programmer's Guide . 


LINE POOL SPECIFICATIONS 


In generating the TCAM message control program, the user defines each 
physical terminal and logical unit to TCAM by means of a TCAM TERMINAL 
macro instruction. Because CICS/OS/VS also requires terminal 
definitions, the user must prepare a terminal control table terminal 
entry (TCTTE) for each terminal or logical unit in a DFHTCT 
TYPE=TERMINAL macro instruction. As a result, a one-for-one correlation 
exists between terminal definitions in TCAM and in CICS/OS/VS. 

In a highly restricted environment, this duplication of terminal 
definitions can be reduced by using the POOL feature (DFHTCT 
TYPE=LINE,POOL=YES) and by specifying LASTTRM=POOL in DFHTCT 
TYPE=TERMINAL on the last TCTTE. Instead of a one-for-one relationship. 
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a "pool" of generalized TCTTEs is defined for a TCAM process queue 
(line). When a transaction is received over the TCAM "line," a search 
is made for an available TCTTE in the pool. When one is found, it is 
assigned the source terminal identification and netname for the duration 
of the task. Upon completion of the task, the TCTTE is available for 
reassignment. If there are no available TCTTEs to handle the next 
transaction from the line, the line remains locked until a TCTTE becomes 
available through task completion. The number of TCTTEs in the pool 
influences the degree of multitasking. 


Line Pool Restrictions 


The user must be aware of the following line pool restrictions: 

1. Because of certain device dependencies within CICS/OS/VS, only one 
terminal type is permitted for each TCAM line (process queue). 

2. Automatic task initiation and BMS message routing are not 
applicable in the pool environment. 

3. Statistics are accumulated for each TCTTE in the pool; however, the 
statistics cannot be correlated to the physical terminals or 
specific logical units. 

4. only one sign-on can exist for all terminal entries in a given line 
pool at any one time. The first sign-on received by CICS/OS/VS is 
propagated to all terminals in the pool. Any subsequent sign-on is 
rejected. A sign-off clears the sign-on data from all terminal 
entries in the pool; a subsequent sign-on is then accepted. 

5. Terminal, line, and control unit requests by the master terminal 
are invalid for pooled terminals. 


LINE LOCKING 


Two types of line locking can occur: 

1. A temporary lock that resolves itself in time, and 

2. A permanent lock that remains permanent unless the user takes 
action in his terminal error program. 

A temporary line lock occurs when no TCTTEs are available in the pool 
and a new transaction appears on the input queue. CICS/OS/VS locks the 
queue until an existing task completes execution, thus freeing a TCTTE. 
In this case, the completion of existing tasks is not dependent upon 
additional input from the queue. 

A permanent line lock can occur when multiple reads are required to 
complete a task. For example, assume that there are two TCTTEs in the 
pool, that a task is attached to each, and that the messages in the 
input queue are in the following order: 

• Message #1 for a third transaction 

• Subsequent messages for the two active tasks 

Because no TCTTE is available in the pool for the third transaction, 
it must wait for a task to complete for a TCTTE to become available. 
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Because the TCAM input queue is processed sequentially, tasks 1 and 2 
are unable to receive their subsequent messages. Hence, they cannot 
complete, and the queue remains permanently locked. 


QUEUE CONSIDERATIONS 


Because a queue is a sequential data set, the second message on the 
queue cannot be retrieved until the first message has been processed. 

To keep messages flowing smoothly through the queue, it is essential 
that each message be processed as soon as it arrives. In the 
CICS/OS/VS/TCAM Interface, "processing the message" means detaching the 
message from the special input TCTTE and attaching it to the individual 
TCTTE correlated to the actual physical terminal or logical unit. Each 
individual TCTTE may be considered to be a "destination" for the purpose 
of this discussion. 

If a particular destination (TCTTE) is not ready to accept the 
current message on the queue, the queue necessarily "locks" until the 
destination can accept the message. Queue locks are only a problem when 
a queue is serving more than one destination. Then, if a queue locks, 
any new transaction on the queue, or messages queued for existing tasks, 
are not processed until the required destination has accepted the 
current message. 

Because queue locks can adversely affect system performance, it is 
important that the user understand their cause and effect. Proper 
configuration of TCAM process queue and CICS/OS/VS terminal control 
tables reduces the occurrence and duration of queue locks to a minimum. 

The maximum number of terminals that can be attached to one queue is 
governed by the amount of activity expected and by the response time 
required from the system. It is suggested that, for high activity and 
low response times, the number of terminals should not exceed twenty- 
five. It should be noted that only a real performance test can verify 
whether this figure is acceptable. 

Because TCAM can read ahead from the terminals, it is possible for 
TCAM to present to CICS/OS/VS a new transaction message destined for a 
TCTTE that is already processing a task. Also, TCAM can present a 
message for an existing task prior to that task issuing a READ request. 
In either case, CICS/OS/VS cannot "process" the message (as described 
above) until the TCTTE is ready to accept the new TIOA. Such input is 
called "unsolicited input." 

Five conditions can produce unsolicited input: 

1. The CICS/OS/VS TCTTE for which the data is destined is * OUT OF 
SERVICE f . 

2. The CICS/OS/VS special input TCTTE for the associated input queue 
is * OUT OF SERVICE *. 

3. The CICS/OS/VS TCTTE for which the data is destined is in RECEIVE 
status. 

4. The CICS/OS/VS TCTTE for which the data is destined has an 
associated task that has not issued a READ and the period of time 
indicated by the NPDELAY specification has expired. 

5. A terminal in a pool has entered data and is unable to find an 
available TCTTE. 
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In all cases, the action taken by the CICS/OS/VS/TCAM Interface is to 
place the input line OUT OF SERVICE and attach DFHTACP to process the 
error condition. 

The default action taken by DFHTACP (which can be altered by a user- 
written DFHTEP) for conditions 1, 2, and 3 is to discard the data and 
place the input line IN SERVICE. No default action is taken by DFHTACP 
for condition 4 or 5? therefore, the input line is placed IN SERVICE but 
with the same message still to be processed, thereby preventing 
CICS/OS/VS from reading any subsequent messages from the input queue. 

To allow processing of input to continue, DFHTEP may take appropriate 
action. If the input line is placed IN SERVICE by DFHTEP, the 
CICS/OS/VS/TCAM Interface retries the operation; in this case, a count 
mechanism is recommended in DFHTEP to prevent a loop in the event that 
the task never issues a READ or a TCTTE never becomes available. 
Alternative action, perhaps when a count limit is reached, might be to 
abend the task, dispose of the data, and place the line IN SERVICE. For 
| further information concerning DFHTEP, see "Terminal Error Program" in 
Chapter 4.2. 

The problem of unsolicited input caused by condition 5 can be 
eliminated entirely by having a separate TCAM input process queue for 
each CICS/OS/VS terminal (TCTTE). However, as the number of terminals 
increases, this solution may quickly become prohibitive in terms of main 
storage requirements. 

The user should analyze the type of traffic that is anticipated over 
the queues. If a 2770 Data Communication System or a 2780 Data 
Transmission Terminal is to read in volumes of cards, separate queues 
should be considered for these devices. The asynchronous transaction 
processing (ATP) function in CICS/VS should be seriously considered for 
processing batches of data to minimize the time between task READ 
requests. For conversational traffic with short-lived tasks, the 
sharing of queues is certainly feasible. The same TCAM output process 
queue can be specified for multiple input process queues. (See the 
discussion of the DFHTCT TYPE=LINE,OUTQ=symbolic name specification in 
Chapter 3.2 of this manual.) 

The user need not be concerned with locking of the TCAM output 
process queue, because TCAM requeues the data by final destination once 
it arrives over the output queue. 

It is possible for the TCAM output process queue to become congested 
because of lack of queueing space. In this case, CICS/OS/VS has a WRITE 
to the queue outstanding until TCAM accepts the data. 


TCAM DEVICES 


In the non-TCAM environment, the CICS/OS/VS terminal control program is 
responsible for polling and addressing terminals, code translation, 
transaction initiation, task and line synchronization, and the line 
control necessary to read from or write to a terminal. When TCAM is 
specified, terminal control relinquishes responsibility to the TCAM MCP 
for polling and addressing terminals, code translation, and line 
control. To take advantage of TCAM facilities, the user must accept the 
responsibility of coding in the MCP message handler functions such as 
code translation previously handled by the CICS/VS terminal control 
program. 

For some terminal services, it is necessary for CICS/OS/VS to pass 
the user request on to the TCAM MCP message handler. A communication 
control byte (two bytes if TCAM SNA) in the TCAM work area has been 
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established for this purpose- It is passed to TCAM along with the 
eight-byte destination name field. Based on the communication byte, the 
user must execute the proper MCP message handler macro instructions to 
accomplish the necessary function. 

The terminal services parameters that do not set bits in the 
communication control byte are WRITE, WAIT, and SAVE. Bits in the 
communication control byte are set for the 2260 parameters WRITEL and 
READL, for the DISCONNECT, FMH, CONVERSE parameters, and for the LAST 
parameter on the WRITE macro. 

The CICS/OS/VS/TCAM Interface does not support the RESET parameter or 
the 3270 parameters READB and COPY. 

All messages to TCAM from CICS/OS/VS are prefixed with the standard 
CICS/OS/VS/TCAM communication area. This is one byte for the non-SNA 
TCAM interface, and two for the TCAM SNA interface (that is, when 
TCAMFET=SNA is specified in DFHTCT TYPE=LINE). This area is used to 
convey special requests and options to TCAM that cannot be used within 
CICS/OS/VS (such as WRITEL to a 2260). 

The format of the communication area is: 


First byte 


FMH present in stream X*01* 
Extended CCB (2 byte CCB) X l, 04 ,# 
DISCONNECT request X’08' 
READL (read keyboard) X* 10'* 
WRITEL (write keyboard X f 20" 


Second byte (present if extended CCB is on) 


Last output from transaction 
READ requested after this WRITE 


X'Ol* (WRITE,LAST) 

X f 02* (WRITE,READ request or CONVERSE) 


All other flags are reserved and are set to zero. 


TCAM GENERALIZED MESSAGE FORMAT 


Messages passed to CICS/OS/VS from TCAM and vice versa have the 
following format: 
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destination 


CCB 


device dependent data 


FMH 


message 


8 bytes 2 bytes x bytes y bytes 

(optional) (device dependent) (SNA only) 
(SNA only) 


destination = destination name (8 bytes) taken from TCTTE's 

netname parameter or from DEST specification 
on output. 

CCB = communication control byte(s) 

This determines the options specified for 
the message (for example, whether an FMH is 
present or not. The length of the CCB varies 
from: 

0 bytes (input message non-SNA) 

1 byte (output message non-SNA) 

2 bytes (input/output messages - SNA) 

device dependent data = dependent on the device - 2260, 3270, or other. 

See the following sections on 
the relevant devices. 

FMH = function management header 

SNA only = length in first byte 
non-SNA = not applicable. 

message = user data 


TCAM WITH 2260 DISPLAYS 


The CCB and device-dependent data for 2260 devices have the following 
formats 



CCB contains; 

device dependent data: 
Byte 1 

Byte 2 


X* 08' DISCONNECT request 
X*10 1 READL 

X'20* WRITEL 


X'AO* Set WRITE direct 
X* B0'* LINEADR request 
X*E0' ERASE request 

Line addressing character (if specified) 


TCAM WITH 3270 DEVICES 

The CCB and device-dependent data for an input message from TCAM to 
CICS/OS/VS have the following formats 
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AID 

CURSOR 



1 byte 

2 bytes 


(SNA only) 


The CCB is present for TCAM SNA lines only. 

The CCB and device dependent data for 3270 output messages from 
CICS/OS/VS to TCAM have the following format: 


CCBl 

CCB2 

1 

2 

3 

1 byte 

1 byte 

1 byte 

1 byte 

1 byte 


(2 bytes - SNA) device dependent data 

(1 byte - non SNA) 


1 Escape character 

2 Command 

3 WCC (write control character) 

Note: For 3270 SDLC devices, the escape character must be removed by 

the message handler. 

All SOH% status messages input to CICS/OS/VS are passed to 
DFHTACP/DFHTEP- 

Terminal control copy and read buffer requests are not supported by 
the CICS/OS/VS/TCAM Interface. 

In addition to normal read/write functions, the ERASEAUP, CTLCHAR, 
UCTRAN, and COMPAT operands are also valid for the 3270- 

All 3270 printer scheduling and error handling is provided by the 
TCAM message handler. 


TCAM USER EXITS 

The three user exits available to the TCAM user are XATTACH, XTCMIN, and 
XTCMOUT. Whereas XATTACH is shared by other users, XTCMIN and XTCMOUT 
are available only to TCAM users and are used in place of the XINPUT and 
XOUTPUT exits used by others- See "Creating User Exits for CICS/VS 
Management Programs" in Chapter 6.2 for further information concerning 
CICS/OS/VS user exits. 


TASK ATTACH USER EXIT (XATTACH) 


This operand is used to generate linkage in the terminal control program 
TCAM module to a user-written exit routine. The linkage is generated at 
the point prior to issuing a task control ATTACH for a transaction 
identification received in response to polling. In the CICS/OS/VS/TCAM 
Interface this information is received over the TCAM input process 
queue. 


INPUT USER EXIT (XTCMIN) 

This operand is used to generate linkage in the terminal control program 
TCAM module to a user-written exit routine. The linkage is generated at 
the point following the completion of any input event. If specified. 
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the linkage is executed after the individual TCTTE is located, just 
before CICS/OS/VS checks to see if a task is attached to the TCTTE. At 
this time, the LIOA contains the 12-byte storage accounting field and 
the work area from TCAM. The work area contains an eight-byte source 
terminal identification header, the CCBs if TCAM SNA, and the work unit 
(user data)• TIOABAR points to the line I/O area containing the origin 
field and user transaction data* TCTTEAR points to the corresponding 
TCTTE for this message, and the TCTTEDA field within the TCTTE points to 
the TIOA which is to be used to contain the edited message* 

The user has two options in returning from the user exit* If the 
user returns with a displacement of four bytes (an assembler B 4(14) 
instruction), CICS/OS/VS removes the eight-byte source terminal 
identification field and the CCBs if TCAM SNA input. Upon completion, 
the TIOA contains the 12-byte CICS/OS/VS storage accounting field and 
the work unit. (See Figure 5.3-4.) 

If the user returns from the exit with a zero displacement (an 
assembler B 0(14) instruction), CICS/OS/VS does not alter the data in 
the TIOA. It is then the user’s responsibility to handle the TCAM 
header. 

For a discussion of TCAM work areas and work units, refer to the 
OS/VS TCAM Application Programmer’s Guide . 


OUTPUT USER EXIT (XTCMOUT) 

This operand is used to generate linkage in the terminal control program 
TCAM module to a user-written exit routine. The linkage is generated 
for output events at the point prior to placing data on the TCAM output 
process queue. 

The user has two options in returning from the exit. If the user 
returns from the exit with an assembler B 4(14) instruction, CICS/OS/VS 
inserts in the TIOA, between the 12-byte CICS/OS/VS storage accounting 
field and the work unit, a TCAM header consisting of an eight-byte 
destination field and the communication control byte or bytes required 
for TCAM. If the user returns from the exit with an assembler B 4(14), 
CICS/OS/VS obtains an LIOA if necessary, inserts a TCAM header 
consisting of an eight byte destination name, communication control 
area, and any device dependent data, and copies user data from the TIOA. 
The LIOA is then used to transmit the data to the TCAM queue. If the 
user returns from the exit with an assembler B 0(14) instruction, 
CICS/OS/VS bypasses this insertion routine. It is then the user’s 
responsibility to ensure that the TCAM header is properly formatted. 

Figure 5.3-4 shows the composition of the TCAM work area and the 
CICS/OS/VS line and terminal input/output areas (LIOA and TIOA) at the 
various stages of operation. On input (1.), it shows the information 
available from the TCAM input process queue. At 2., the CICS/OS/VS/TCAM 
interface has obtained a line I/O area and has received the TCAM message 
into that area. This is the state when input event completion has just 
taken place. If default editing is then performed, a TIOA (as at 3.) is 
obtained and the relevant data is copied from the LIOA in 2. to this 
TIOA (that is, the origin field, CCB (if any), and device dependent data 
are removed). This TIOA is then given to the user. On output, a TIOA 
(as at 3.) is provided by the user. The CICS/OS/VS/TCAM interface 
obtains an LIOA (at 4.) if necessary, and inserts a destination name, a 
CCB, and device dependent data before copying the user transaction data. 
This information, beginning at the start of the work area, is placed in 
the TCAM output process queue. 
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1. TCAM Work Area from 
the input process queue 


8 bytes - 
, Origin 

H-— \ 


1, 


I 


CCB j FMH | 
I (optional) { 


User transaction data 


Start of 
work area 
\ 

\ 

\ 


2. LIOA after input 
event completion: 


12 bytes 

Storage 

accounting 


Start of 
work unit 
\ 

\ 

8 bytes —-H 

Origin CCB j FMH 


field 


I 


End of 
work area 

A 

\ 

\ 

\ 


A 

lioa\ 


\ 


| (optional) | User transaction data 


\ 


/ 


\ 


/ 


\ 


3. TIOA after CICS editing 


\ / 

\ / 

\ / 

— 12 bytes ——x bytes — 
Storage \ FMH | 

accounting | (optional) \ 


/ 


A 


User transaction data 


TIOA 


4. LIOA before output Event 
Completion after CICS 
insertion routine: 


12 bytes - 

Storage 

accounting 


A 
/ \ 

/ \ 


’ 8 bytes ^ 

Destination CCB FMH 
field 


| (optional) | User transaction data 


LIOA 


The work area is placed on 
the TCAM output process queue 


Start of 
work area 


Communication 
control byte(s) 

+ device dependent 
flags 


End of 
work area 


Figure 5.3-4. Stages of TCAM Work Area and CICS/OS/VS Input/Output 
Areas 


The TCAM origin field contains the source terminal network name 
(netname). 

The TCAM destination field contains the destination identification 
for TCAM to route the data properly. 

If the user specifies the output user exit and returns from the exit 
with a zero displacement, CICS/OS/VS does not alter the TIOA work area. 
The user must provide the data length at TIOATDL and must prepare the 
work area for TCAM, including the eight-byte destination field and the 
communication control byte (bytes if TCAM SNA). 


CICS/OS/VS/TCAM STARTUP 


The TCAM MCP must be in operation prior to completing CICS/OS/VS system 
initialization. When the user brings up CICS/OS/VS with the 
CICS/OS/VS/TCAM Interface, CICS/OS/VS checks for the presence of a TCAM 
partition/region and issues the operator message: 

DFH1500 - CICS CHECKING FOR TCAM MCP 

If CICS/OS/VS discovers the MCP is not operational, the following 
messages are issued: 
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DFH1520 - TCAM MCP IS NOT CURRENTLY AVAILABLE 
DFH1520 - REPLY RETRY OR CANCEL OR CONTINUE 

The operator must then respond: 

RETRY 

when the TCAM partition/region becomes active; or 
CANCEL to terminate CICS/OS/VS; or 
CONTINUE 

to continue initialization of CICS/OS/VS in the absence of the TCAM 
partition/region. 

If the operator responds CONTINUE, all DD cards that refer to a TCAM 
queue must have been previously removed from the startup deck to avoid 
an abnormal termination of CICS/OS/VS. The CONTINUE response is 
applicable to a mixed BTAM/TCAM mode of operation when TCAM lines are 
not being used during execution of CICS/OS/VS. 


CICS/OS/VS/TCAM ABEND/RESTART 


If the TCAM message control program (MCP) terminates abnormally, any 
TCAM application programs currently active are automatically terminated 
abnormally, providing there is at least one open line group in the MCP. 
The CICS/OS/VS application program is no exception. For further 
information, see the relevant sections in the OS/VS TCAM System 
Programmer's Guide and in the OS/VS TCAM Application Programmer's Guide . 
CICS/OS/VS does not provide RESTART capability. 


CICS/OS/VS/TCAM TERMINATION 


CICS/OS/VS is terminated in the normal manner. No modifications to 
termination procedures are required to support the CICS/OS/VS/TCAM 
Interface. If both CICS/OS/VS and TCAM are being terminated, CICS/OS/VS 
should be terminated first to avoid an abnormal termination of 
CICS/OS/VS. - * 


CICS/OS/VS AND TCAM: PROGRAM INTERRELATIONSHIP 


Figure 5.3-5 illustrates the interrelationship between the TCAM message 
control program (MCP) and the TCAM application program. CICS/OS/VS is 
regarded as an application program by TCAM. 
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TCAM MCP 


3270 (Remote) 


CICS/OS/VS Application program 



2260s (Local) 

( ~TRM 2 
( TRM1 


LG2260 

DCB 


TOTCAM 

message 

handler 


DD Cards 

DDLG3270 DD UNIT=xxx 
DDLG2260 DD UNIT=(a, b) 


R700 

TPROCESS 


WIS1 

TPROCESS 



SDSCI(DCB) 


TCTLE 

DDNAME= 

QIN1 

OUTQ= 


RIS1 

TPROCESS 



^ 1 

TCTTE 

"DMMY" 



i SDSCI(DCB) 



TCTLE 

DDNAME= 

QOUT1 


DD cards 

//QIN1 DD QNAME=RIS1 

//QOUT1 DD QNAME=WIS1 

//R3270IN DD QNAME=R70I 

//R3270OUT DD QNAME=R700 


Figure 5*3-5. TCAM Message Control and Message Processing Program 
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The following is an example of a TCAM message control program. This MCP 
shows the relationship between the MCP definition and the CICS/OS/VS 
terminal control table generation. It should not be construed as a 
typical or usable MCP for CICS/OS/VS. For further information on MCP 
definition for a variety of devices, refer to the OS/VS TCAM 
Installation and Migration Guide . An example of a CICS/OS/VS terminal 
control table for TCAM can be found in Appendix B. 


TCAM MESSAGE CONTROL PROGRAM (NON-SNA) 


MCPCICS 

CSECT 



TCAMINIT 

INTRO 

DISK=NO, 

* 



PROGID=TCAM/CICS, 

* 



LUNITS=40, 

♦ 



MSUNITS=20, 

* 



KEYLEN=132, 

♦ 



CR0SSRF=4, 

♦ 



DLQ=TRMl, 

* 



STARTUP=CY, 

* 



TRACE=10, 

* 



LINETYP=BOTH, 

OLTEST=0 

* 


LTR 

15,15 



BZ 

OPENLINE 


NOEXEC 

ABEND 

123,DUMP 


OPENLINE 

OPEN 

(LG2260,(INOUT),PG3270,(INOUT)) 



TM 

LG2260+48,DCBOFLGS 



BNO 

NOEXEC 



TM 

PG3270+48,DCBOFLGS 



BNO 

NOEXEC 



WTO 

READY 

•TIME TO START APPLICATION PROGRAM'* 


FINISH 

CLOSE 

CLG2260,,PG3270) 



L 

13,4(13) 



RETURN 

(14,12) 


LG2260 

DCB 

DSORG=TX, 

* 



MACRF=(G,P), 

* 



CPRI=S, 

♦ 



DDNAME=DDLG2260, 

* 



MH=TOTCAM, 

* 



PCI=(N,N), 

* 



BUFSIZE=464, 

INVLIST=(P0LLST1,,.POLLST2),TRANS=EBCD 

* 

PG3270 

DCB 

DS0RG= TX,MACRV=(G,P),CPRI=S,DDNAME=DDPG3270, 

♦ 



MH=MH3 27 0,PCI=(N,N),BUFSIZE= 464, 

INVLIST=(POLL70R,,),TRANS=EBCD 

* 

QPROC 

PCB 

MH=TOCICS, 

* 



BLKSIZE=464, 

RESERVE=(20) 

♦ 


TTABLE 

LAST=TRM2 


RISl 

TPROCESS PCB=QPROC , QUEUES=MO 

* 

WIS1 

TPROCESS PCB=QPROC 


R70I 

TPROCESS PCB=QPROC,QUEUES=MO 


R700 

TPROCESS PCB=QPROC 


T32C 

TERMINAL QBY=T,DCB=LG 327 OR, RLN=1, TERM=327C,QUEUES=MO 


S70A 

TERMINAL QBY=T,DCB=PG3270,RLN=1,TERM=327R,QUEUES=MO, 

♦ 



ADDR=616140402D,NTBLKSZ=1856,SECTERM=YES 


S70B 

TERMINAL QBY=T,DCB=PG3270,RLN=1,TERM=327R,QUEUES=MO, 

♦ 



ADDR=6161C1C12D,NTBLKSZ=1856,SECTERM=YES 


S75A 

TERMINAL QBY=T,DCB=PG3270,RLN=1,TERM= 3 2 7R,QUEUES=MO, 

* 



ADDR=E2E240402D,NTBLKSZ=1856 


TRM1 

TERMINAL QBY=T, 

* 



DCB=LG2260, 

* 
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TRM2 


P0LLST1 

POLLST2 

POLL70R 


♦ 

TOTCAM 


INMSG 


* 

MH3270 

SOH 

INBUF 

MSGEDIT 


TOCICS 


DCBOFLGS 


Chapter 


RLN=2, 

TERM=226L, 

QUEUES=MO, 

ADDR=FFFFFFFF, 

SECTERM=YES 
TERMINAL QBY=T, 

DCB=LG2260, 

RLN= 2 , 

TERM=226L, 

ADDR=FFFFFFFF, 

QUEUES=MO 

INVLIST ORDER=(TRM1+02) 

INVLIST ORDER =CTRM2+02) 

INVLIST 0RD3R =(T32C-C1C17F7F2D,S70A+C1C140402D, 
S70B+C1C1C1C12D, 

S75A+C2C27F7F2D,S75A+C2C240402D), 
EOT=37 


* 

* 

* 

* 

* 

* 

* 

♦ 

* 


* 

* 

* 


STARTMH LC-OUT 2260 MH 

INHDR PROCESS INCOMING MSG HEADER 

CODE 

FORWARD DEST=C f RISl " 

PROCESS INCOMING COMPLETE MSG 

INEND 
OUTHDR 
OUTEND 


END OF INCOMING SECTION 
PROCESS OUTGOING MSG HEADER 
END OF OUTGOING SECTION 


STARTMH LC=OUT# CONV—YES • STOP=YES 3270 MH 


INHDR, 

MSGTYPE X 1 6C* 

B SOH 

MSGTYPE 

MSGEDIT ((R,CONTRACT,SCAN,<2)1 

EQU DS OH 

CODE 

FORWARD DEST=C - R70I w 

INMSG 
INEND 
OUTHDR 
SETSCAN 1 
( (R, , SCAttt) ) 

MSGFORM 

CODE 

OUTBUF, 

OUTMSG 

OUTEND 

STARTMH LC=OUT 

INHDR 

CODE 

FORWARD DEST=PUT 

INEND 

OUTHDR 

OUTEND 

EQU X‘10* 

END 


PROCESS INCOMING MSG HEADER 
IS IT A STATUS MESSAGE 
IF SO, BRANCH ROUND 
ALL OTHER MSGS TO HERE 
»,BLANK=NO REMOVE CUDV BYTES 


INCOMING MSG SEGMENT SECTION 
SECTION FOR COMPLETE MSGS 
END INCOMING SECTION 


REMOVE CCB 

SETS IN LINE CONTROL CHARS 


END OUTPUT SECTION 
MH FOR APPLICATION 

TRANSLATE TO EBCDIC 
WRITE TO CICS 
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Chapter 5.4. Writing a Transaction to IPL the 

System/7 


| The IBM System/7 may be used under two line protocols in a CICS/VS 
j environment. The chapter provides information on writing a transaction 
j to IPL the System/7 on start/stop and BSC lines. 


ON A START/STOP LINE 


To initial program load (IPL) the System/7 from CICS/VS, the user must 
write a transaction that issues an automatic transaction initiation 
request to either interval control or transient data control. This 
transaction is usually initiated from the master terminal or from a 
sequential terminal. The initiated transaction is started on the 
System/7; it then writes the IPL records to the System/7. 

The IPL records are prepared by the user and consist of: 

• UZERO, a utility module 

• UTIPL, a utility module 

• System/7 storage load 

UZERO and UTIPL are provided in object deck form on the MSP/7 
distribution tape under member names CAAUZERO and CAAUTIPL, 
respectively. If link-edited into the user-written application program, 
UZERO and UTIPL are available for transmission in a suitably translated 
format. 

The first two bytes of each of these modules is a count of the number 
of characters in the remainder of the module. These two bytes must be 
placed in the user's TIOA at TIOATDL by the application program. The 
remainder of the module is moved to TIOADBA. UZERO and UTIPL may then 
| be transmitted to the System/7 by issuing terminal output requests with 
| the WAIT option in the application program. 

The System/7 storage load is generated by the formatting utility 
(FORMAT/7) by specifying "PARM-TCOM" in the execute card of the 
formatting job step. The storage load is comprised of 80-character 
records that may be read using the transient data or file control 
facilities of CICS/VS and transmitted to the System/7 by issuing a 
| series of terminal output operations with the WAIT option. If a DFHPC 
RETURN request is used to allow the System/7 to begin execution, the 
user must ensure that no automatically initiated transaction is 
scheduled to begin on the System/7 until at least 10 seconds have 
elapsed following execution of the DFHPC RETURN request. 

For more information concerning the preparation of IPL records for 
the System/7, see the publication IBM System/7 MSP/7 Host Program 
Preparation Facilities II on System/360 or System/370: Assembler, 
Linkage Editor. Formatting Utility, and Source Preparation Program . 
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USING A BSC LINE 


CICS/VS supports the initial program load (IPL) of a System/7 with the 
binary synchronous communications adapter (BSCA) using a multipoint line 
only - This feature requires that a terminal entry (TCTTE) be generated 
which includes the following parameters: 

TRMTYPE=S/7BSCA, 

TRMSTAT=IPL, 

TRMADDR=label, 

FEATURE=TRANSPARENCY,... 

The DFTRMLST pointed to by the TRMADDR parameter must specify an 
address in the form (SEL SEL DC1 DCl ENQ), where SEL is the System/7 
selection address- This logical terminal is used exclusively for the 
IPL of the System/7. One additional TCTTE is required for each logical 
terminal in the System/7. The number of logical terminals that reside 
in a System/7 is limited by the application program running in the 
System/7• 

No entry should be made in the polling list for the System/7 IPL 
logical terminal. 

To IPL the System/7 from CICS/VS, the user must write a transaction 
that issues an automatic transaction initiation request to either 
interval control or transient data control. This transaction is usually 
initiated from the master terminal or from a sequential terminal. The 
initiated transaction is started on the System/7? it then writes the IPL 
records to the System/7. 

The IPL records are prepared by the user and consist of the 
following: 


$UBIPL (the bootstrap loader) 

System/7 Storage Load 

$UBIPL is supplied with MSP/7. The System/7 Storage Load is written 
and assembled by the user. CARD format must be specified for the 
execution of FORMAT/7, the MSP/7 formatting utility. The user-written 
CICS/VS transaction that transmits the $UBIPL and the Storage Load 
records to the System/7 will use the following macro: 


DFHTC TYPE=(WRITE,WAIT,TRANSPARENT) 

For further information, see the manual MSP/7 Macro 
Library/Relocatable: Coding the Input/Output Macros . 
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Chapter 5.5. 2260 Compatibility for the 3270 


This discusses the subject of running 2260-based transactions on the 
3270, and covers the following topics: 

• The two modes of 2260 compatibility - FORMAT and FULLBUF modes. 

• The entries required in the terminal control table to generate 2260 
compatibility support. 

• The data streams for the various models of the 2260. 

• The various screen techniques for entering data on the 2260. 

• Start-of-message indicator, new line symbol, line addressing, 2848 
lock feature, and 2845/2848 tab feature in relation to the 2260. 

• How to initiate transactions from a 3270 in 2260-compatibility 
mode. 


2260 compatibility support for the BTAM-supported 3270 Information 
Display System allows the user to run currently operational 2260-based 
transactions from a 3270. 2260 compatibility is not supported for 3270s 

operating through VTAM. 

During CICS/VS system generation, the user must request that 2260 
compatibility be included, thereby generating the necessary code to 
provide conversion of 2260 data streams from user-written application 
programs to the appropriate 3270 data stream format. When the 3270 
operates with a "compatibility" transaction, incoming data from the 3270 
is converted and presented to the user-written application program in 
2260 format. In most cases, no changes are required to the user-written 
program. 

Because 2260 compatibility is specified by transaction as well as by 
terminal, non-2260-based transactions have full access to all facilities 
of the 3270. Only when a 2260-compatible transaction is attached to a 
2260-compatible 3270 does CICS/VS perform the editing of the input and 
output data streams. If the transaction is not specified as 2260 
compatible, or if the terminal is not specified as supporting 2260 
compatibility, no editing occurs for the data streams. In that case, if 
the data streams are not valid 3270 data streams, the results are 
unpredictable. 


MODES OF 2260 COMPATIBILITY 

Two modes of 2260 compatibility operation are provided: FORMAT and 
FULLBUF. 

FORMAT mode takes full advantage of the 3270 formatting and data 
compression facilities, and is the preferred method of 2260 
compatibility, particularly for the operation of remote 3270s. However, 
some 2260 facilities cannot be supported under FORMAT mode. For 
information concerning which facilities are available, see "Screen 
Techniques." 
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FULLBUF mode does not use the 3270 data compression facilities and 
must therefore be used when all lines of input data are desired. For 
each operator interaction involving a data entry key (ENTER, PF1 - 
PF12), the number of characters transferred is approximately equal to 
the total number of characters on the simulated 2260 screen. The exact 
number of characters transferred varies, depending upon whether the 3270 
is local or remote and which model of the 2260 is being mapped onto 
which model of the 3270. 

Note : A terminal is considered to be in compatibility mode from the 

time a 2260-compatible transaction is initiated until (1) the CLEAR key 
is pressed, or (2) a 3270 native mode transaction is initiated. 

For local 3270 operation, the extra data transfer of FULLBUF mode 
should be transparent to the user with regard to response time. For 
remote 3270 operation, the response time is a complex function of the 
present method of 2260 operation and the line speeds used for the 2260 
and 3270; however, the increase in the response time (on a transaction 
basis) should be less than 20% at the same line speed. 


CICS/VS TABLE PREPARATION FOR 2260 COMPATIBILITY 


Individual transactions can be flagged for FORMAT or FULLBUF 2260 
compatibility through the DFHPCT TYPE=ENTRY macro instruction. The mode 
of compatibility chosen depends on the 2260 functions required for the 
application programs that, are to run under this particular transaction 
code. 

| The characteristics of the 2260/2265 terminal (which the 3270 display 
replaces) are specified by additional operands for the DFHTCT 
TYPE=TERMINAL macro instruction. They are as follows: 


COMPAT={NO|(characters,lines,device,model)> 

The "characters" parameter is used to specify the screen size of the 
2260/2265 terminal. Applicable parameter values are 240, 480, and 960. 

The "lines" parameter is used to indicate the number of lines 
applicable to the 2260/2265 terminal or to insert new line (NL) symbols 
| into the 3270 printer output data stream where NL symbols are not 
provided by the user in the output data stream. Applicable parameter 
values are 6, 12, and 15. The default value for a 960-character screen 
is 12. 

The "device" parameter is used to specify a 2260 or 2265 terminal or 
a 1053 printer. The default is 2260. Note that a specification of 
COMPAT=(960,15) would result in an error condition, because the 2260 
(assumed by default) cannot support 15 lines. 

The "model" parameter is used to specify a model number for the 2260 
terminal being simulated. This parameter provides an interface for any 
user-written application programs that currently test the TCTTETM field 
before building device-dependent 2260 data streams. 

The FEATURE operand has been included in the CICS/VS DFHTCT 
TYPE=TERMINAL macro instruction to indicate the presence of 3270 
Information Display System features. These are, PTRADAPT, SELCTPEN, 
AUDALARM, COPY, DCKYBD, UCTRAN, and PRINT. The meanings of these 
parameters are: printer adapter, selector pen, audible alarm, copy 
feature, dual case keyboard, uppercase translation, and print request 
support respectively. 
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Note : Printer adapter specifies the corresponding 3284 Model 3 Printer 

on the 3275 Display Station. A separate DFHTCT TYPE=TERMINAL macro 
instruction cannot be coded for the 3284 Model 3 Printer because the 
3284 Model 3 shares the buffer of the 3275 Display Station. 


2260 MODEL-DEPENDENT DATA STREAM 


Some users require the capability of building 2260 device-dependent data 
streams. CICS/VS allows the user to build such data streams by 
providing the terminal type at TCTTETT in the terminal control table 
(TCT) and the terminal model number at TCTTETM in the TCT. 

The TCTTETT and TCTTETM fields always contain the 2260 or 2265 
terminal type codes and user-assigned model number (as specified in the 
DFHTCT TYPE=TERMINAL macro instruction) whenever a transaction flagged 
for CICS/VS 2260 compatibility is dispatched. At all other times, 
TCTTETT and TCTTETM contain the codes for the 3270 terminal. 


SCREEN TECHNIQUES 


Various techniques have been used for entering data using a 2260 screen 
and keyboard. The following are examples of four basic techniques that 
may be used. 

1. Formatted 2260 screen technique; for example: 


► USER KEYED DATA X* 

X-X A 

X - X A 

X-X A 

X-X A 

X-X- 


X-CONSTANT DATA X 


With this technique, the constant data is optional and is sent to 
the user at the start of the transaction. Either FORMAT or FULLBUF 
mode may be specified, depending upon the user's formatting 
requirements. 

2. 2260 tab feature technique; for example: 


► NAME: 

INITIAL: 

STREET: 

NUMBER: 

CITY: 

STATE: 
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For CICS/VS 2260 compatibility operation, the colon-tab character 
combination is replaced by 3270 "unprotected attribute" characters. 
FORMAT mode may be specified if data is always keyed into every 
field. FULLBUF mode must be specified if any field is to be left 
blank. (Unlike the 2260, the 3270 does not transmit blank 
characters unless FULLBUF is specified.) If FULLBUF is not 
specified, any heading following the blank field is not transmitted 
to the application program. 


► NAME: 

JONES INITIAL: 

J A 


STREET: 

NUMBER: 

151S A. 


CITY: NEW YORK— STATE: 



FORMAT data stream: 



NAME:JONES 

INITIAL:J(NL) 

: 1515(NL) 

:NEW YORK 

FULLBUF 

data stream: 



NAME:JONES 

INITIAL:J(NL) 

STREET: 

NUMBER:1515(NL) CITY:NEW YORK 


3. "Endless screen" technique; for example: 



With this technique, the 2260 screen is treated as unformatted. 

The operator keys off the screen, and, wrapping around to the start 
of the screen, overkeys any old data still there. The 2260 
transmits a data stream delimited by SMI (start of message) and EOM 
(end of message) characters, irrespective of any screen wrap¬ 
around. 

Either FORMAT or FULLBUF can be specified. In either case, CICS/VS 
ensures that the data stream is correctly ordered before sending it 
to the 2260-based transaction. 

With this technique, there is a difference in operation between 
FORMAT and FULLBUF modes only in the case of a 480-character 2260 
mapped onto a 480-character 3270. Use of FORMAT mode causes the 
loss of the last character of every 2260 output line. Use of 
FULLBUF mode limits the data loss to the last character position of 
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the last line but at the expense of transferring a full 480 
characters (479 characters plus one attribute character) for each 
interaction involving a data entry key. 

It is the responsibility of the user to determine whether his 2260 
transaction can tolerate the loss of the last character of each 
output line. CICS/VS appends a blank character to the end of each 
2260 input line, except where the line is terminated prematurely by 
a new line (NL) symbol. 

4. "Change and enter" technique; for example: 


► JONES 


J H 



1515 


OLD ROAD EAST 


ORIGINAL 

NEW YORK 



RECORD 

N.Y. 

10010 

— 



► JONES 


J H 



1515 


OLD ROAD WEST 


UPDATED 

► 

NEW YORK 



RECORD 

N. Y. 

10010 

- 




The FORMAT data stream looks like this: 


JONES J H 1515 OLD ROAD WEST 


The FULLBUF data stream looks like this: 


JONES 

J H 

1515 

OLD ROAD WEST 

NEW YORK 


N.Y. 

10010 


2260 Compatibility for the 3270 


Chapter 5.5. 
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The 2260 transaction sends an existing record to the screen. After 
making any necessary corrections to data fields, the operator 
depresses the ENTER key; the 2260 transaction receives the entire 
record in its updated version. 

With this technique, FULLBUF must be specified for this transaction 
to ensure that the transaction receives a 2260-compatible data 
stream. 

Note : If binary zeros instead of blanks are used in the output data as 

filler characters, they will be stripped out by the control unit when 
read back from the 3270. This makes data appear to be compressed. 


START OF MESSAGE INDICATOR (SMI) 


For the 2260, X'4A* is displayed as the SMI (►> character. If the SMI 
character is contained in an output data stream, it is displayed on the 
3270 screen as follows: 

Country 


U.S.A. 

U.K. 

France 
Germany 

At the user’s discretion, a different character may be specified 
during CICS/VS system generation to represent the SMI. The character 
chosen remains the same for all transactions. 

If an SMI character is not placed on the screen by the user's 2260 
data stream, the operator must then key an SMI character somewhere on 
the screen. Failure to do so results in no data being transmitted to 
the application program. 

After the data has been read in, CICS/VS 2260 compatibility transmits 
a single blank character to overwrite the SMI character. 

Note : Multiple SMI characters are not allowed on the same screen and 

will result in the error message: "DFH1031 ERROR IN PROCEDURE, CLEAR AND 
REENTER". 


SMI Symbol 


$ 

$ 

$ or 9 
6 


NEW LINE SYMBOL (NL) 


For CICS/VS 2260 compatibility, the new line (NL) function is replaced 
by a field mark character followed by the NL key. Any incoming field 
mark characters are treated as 2260 NL characters, and the remainder of 
the line is discarded. 

Including the NL symbol in the 2260 output data stream causes the 
substitution of a 3270 field mark character? the output continues at the 
beginning of the next line. (The 3270 field mark character displays as 
a semicolon.) 
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LINE ADDRESSING 


For a 3270 operating under CICS/VS compatibility, any requests for write 
at line address are honored. CICS/VS 2260 compatibility converts the 
line address to the equivalent 3270 buffer address before transmitting 
the data stream to the screen. 


2848 LOCK FEATURE 


The optional lock feature available on the 2848 Display Control Models 
21 and 22 is supported by CICS/VS 2260 compatibility. Any read/lock 
request is honored by CICS/VS 2260 compatibility by leaving the 3270 
keyboard inhibited. The keyboard is only reset if the transaction 
changes or if a WRITE macro instruction is issued by the application 
program. 


2845/2848 TAB FEATURE 


The optional tab feature available on the 2845/2848 Display Control is 
supported by CICS/VS 2260 compatibility. Any tab character (colon) 
found in the output data stream is replaced by an attribute byte. This 
attribute byte is converted back to a 2260 tab character on a read 
operation. 

Because the tab feature uses an attribute byte, the terminal operator 
cannot key a tab character from the keyboard. The tab does not display 
on the screen, but is present in the user*s input data stream. 

For proper operation, transactions using the tab technique are 
required to operate in FULLBUF mode. A tab character should not be 
inserted as the last character of a line. 

Because the tab feature uses an attribute byte, the cursor stops at 
the beginning of each line before stopping at the authorized attribute 
position, except in the case of 480/480 FULLBUF conversion- The cursor 
only stops at the authorized attribute position and the last position in 
the buffer. 


INITIATING TRANSACTIONS 


The terminal operator can initiate either 2260 compatibility or 3270 
native mode transactions by entering the appropriate CICS/VS transaction 
code. While in compatibility mode, any start of message indicator (SMI) 
character in the input data stream is recognized by CICS/VS; the 
succeeding four characters are interpreted as a CICS/VS transaction 
code. The transaction code must be contiguous and may not span two 
fields. 

CICS/VS then initiates the specified transaction. If the specified 
transaction is a 2260 compatibility transaction, CICS/VS automatically 
formats the 3270 screen. 

To allow easy transition between 2260 compatibility and 3270 native 
mode transactions, some conventions should be followed. Three 
acceptable methods of transition between transactions are: 
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1. Clear the screen; then enter the transaction code and any data to 
be presented to the transaction. 

In this case, the operator must enter the transaction code at the 
first position of the screen. The transaction code may be preceded 
by the SMI character, in which case the next four characters are 
interpreted as the transaction code. A transaction code may not 
contain an SMI character. 

2. For a terminal in compatibility mode, enter the SMI character, the 
transaction code, and data. If the transaction to be initiated is 
a compatibility transaction, all data from the SMI character to the 
cursor position is treated as a 2260 compatibility data stream and 
is mapped into 2260 format. For a native mode transaction, the 
data stream is identical with the data stream from an unformatted 
screen buffer. 

3. For a terminal in native mode with a formatted screen, the SMI 
character and transaction code must be the first data characters in 
the data stream. If the transaction code calls for a compatibility 
transaction, the screen is formatted for 2260 compatibility but no 
data is presented to the transaction. 
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Chapter 5.6. IBM 3735 Programmable Buffered 

Terminal 


This chapter provides a summary of the specific options which must be 
included in the CICS/VS system generation and table preparation macro 
instructions to provide support for the IBM 3735 Programmable Buffered 
Terminal in a switched line network. The 3735 inquiry mode feature is 
also discussed. 


SYSTEM GENERATION 


BTAMDEV= 3 735D and ANSWRBK=EXIDVER must be included in the DFHSG 
PROGRAM=TCP macro instruction during system generation. 


TERMINAL CONTROL TABLE PREPARATION 


FEATURE=AUTOANSR must be specified in the DFHTCT TYPE=LINE macro 
instruction for all terminals on switched-line networks. To support the 
3735 Programmable Buffered Terminal, the following must also be 
specified: 

• DFHTCT TYPE=LINE,ANSWRBK=EXIDVER 

• BTAM DFTRMLST macro instruction of the form SWLST,AN. The user 
portion of each 3735 DFTRMLST entry must point to the corresponding 
TCTTE 

• DFHTCT TYPE=TERMINAL,TRMTYPE=3735 

If FEATURE=AUTOCALL is specified in the DFHTCT TYPE=LINE macro 
instruction, the following must also be specified: 

• BTAM DFTRMLST macro instruction of the form SWLST,AD 

• DFHTCT TYPE=TERMINAL,TRMADDR=parameter 

The TRANSID operand is required for batch input in the form 
TRANSID=xxxx where xxxx is the transaction identification of the user- 
written batch processor. 


INQUIRY MODE 


CICS/VS deletes the inquiry header on input and inserts it on output. 
Therefore, inquiry applications require that: 

• A single output record is transmitted 

• The output block does not exceed 233 bytes (plus a three-byte 
inquiry header) 

• The output data stream does not contain characters which are 
invalid for a 3735 (see the 3735 Programmer’s Guide ). 
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If multiple inquiries are required in a single connection on a 
switched line, the user must make provision in his DFHTEP program to 
keep the line open. To accomplish this, the user may check for the 
IOERROR - TIMEOUT condition, a WRITE TR or READ TQ instruction, and the 
contents of TCTTEMCI for the value TCTTEMIQ, which is a hexadecimal 
blank character (X*40*). 
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Chapter 5.7. IBM 3740 Data Entry System 


This chapter contains information on the macros and operands which must 
be specified during the CICS/VS system generation and table preparation 
process to provide support for the IBM 3740 Data Entry System in a 
switched line network. The 3740 expanded ID verification feature is 
also discussed. 


SYSTEM GENERATION 


BTAMDEV=3740D must be included in the DFHSG PROGRAM=TCP macro 
instruction during system generation. 


TERMINAL CONTROL TABLE PREPARATION 


FEATURE=AUTOANSR must be specified in the DFHTCT TYPE=LINE macro 
instruction for all terminals on switched-line networks. To support the 
3740 Data Entry System, the following must be specified: 

• BTAM DFTRMLST macro instruction of the form SWLST,AN- The user 
portion of each 3740 DFTRMLST entry must point to the corresponding 
TCTTE. 

• DFHTCT TYPE=TERMINAL,TRMTYPE=3740 

If FEATURE=AUTOCALL is specified in the DFHTCT TYPE=LINE macro 
instruction, the following must also be specified: 

• BTAM DFTRMLST macro instruction of the form SWLST,AD 

• DFHTCT TYPE=TERMINAL,TRMADDR=parameter 


ID VERIFICATION 

If the 3740 does not have the expanded ID verification feature 
(specified in the ANSWRBK=EXIDVER operand of DFHTCT TYPE=LINE macro), 
the first record (block) from the 3740 must contain only the terminal 
identification; any other data in the first block will be disregarded. 
Data must begin in byte 1 of the second block. 
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Chapter 5.8. IBM 3600 Finance Communication 

System (BSC) 


| This chapter contains information on the CICS/VS system generation and 
j table preparation options which must be specified to provide support for 
j the IBM 3600 Finance Communication System in a BSC network* The 3600 
| buffer depletion feature is also described. 


SYSTEM GENERATION 

BTAMDEV=3600 must be specified in DFHSG PROGRAM=TCP to generate 3600 BSC 
support, other terminal control program parameters apply as follows: 

• FEATURE^TRANSPARENCY must be specified if CICS/VS and 3601 
application programs are to communicate in transparent mode. 

• BSCODE=EBCDIC is required for 3600 BSC support. 

• FEATURE=AUTOPOLL is required. 

• WRAPLST=YES should only be specified if the wrap list feature is to 
be included in CICS/VS. 


TERMINAL CONTROL TABLE PREPARATION 


The following parameters must be specified in DFHTCT TYPE=SDSCI for 3600 
BSC devices: 

• DEVICE=3600 if all terminals in the line group are 3600s or 
DEVICE=BSCMDMPT for mixed binary synchronous multipoint devices 
present in the line group. 

• BSCODE=EBCDIC. 

In addition, the following specifications are required for DOS/VS: 

• RETRY=6 to correspond to the 3600 binary synchronous access method 
(BAM). 

• CU=2701 or 2702. 

• CONFIG=MPT and SWITCH=NO, because the 3600 runs as a non-switched 
multipoint tributary only. 

• TERMTST=NO, because BAM does not use the terminal test facility. 

• FEATURE=BSC. 

The poll list generated by the DFTRMLST macro must conform to the 
general poll requirements described for BAM in the IBM 3600 Finance 
Communication System Customer Feature Description for BSC3 Communication 
manual. CICS/VS support requires that a one character component address 
be specified in the 3601 CPGEN as the poll address. If necessary, the 
3600 entries must be padded with leading SYN characters if the line to 
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which the 3600 devices are attached also contains other device types, 
because the poll list entries must all be of the same length. 

The following parameters must be specified in the DFHTCT TYPE=LINE 
macro instruction: 

• TRMTYPE=3600. If a remote 3270 and a 3600 BSC device are both on 
one line, TRMTYPE must specify the remote 3270. 

• GENPOLL—YES. This is the default when TRMTYPE=3600, 3270, or 2980. 

• BSCODE=EBCDIC. This is the default. 

• INAREAL must accommodate the maximum input length, including data 
link control characters, from any device on the line. If a remote 
3270 is attached to the line, the length must not be less than 254. 
For 3600 control units sending unblocked data, the length must not 
be less than the largest message segment written to the host by any 
single work station. For 3600 control units sending blocked data, 
the length must accommodate the maximum allowable transmission, as 
specified in the 3600 CPGEN. 

The following parameters relate to the DFHTCT TYPE=TERMINAL macro 
instruction: 

• TRMTYPE=3600 indicates a 3600 BSC device when the SDSCI and LINE 
macros have also been specified thus. Otherwise, VTAM 3600 support 
will be generated. 

• FEATURE=TRANSPARENCY must be specified if the CICS/VS and 3601 
application programs issue transparent writes. 

If BUFFER^O is specified or defaulted, CICS/VS sends output to the 
3601 in one transmission without segmenting it. Thus, both the 3601 
host input buffers and the receiving work station*s host input segment 
must be large enough to accommodate any CICS/VS application program or 
system message which can be sent to the work station. 

BMS parameters must not be specified because BMS is not supported for 
3600 BSC devices. 


BUFFER DEPLETION 


Buffer depletion occurs when the CICS/VS terminal control program 
attempts to send a message segment to a 3600 controller and receives an 
indication that the 3600 has no buffers currently available to receive 
data from the host. Each data transmission from CICS/VS occupies a 3600 
controller buffer until a work station reads the data into its work 
area. Thus, buffer depletion may occur when 3600 work stations are not 
reading data sent by the host. If it detects a buffer depletion 
condition, the CICS/VS terminal control program waits 1.5 seconds and 
then retransmits the segment. This sequence is repeated until the 3601 
has a buffer available to receive the segment, or until some other error 
occurs. 
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Part 6. Modifying CICS/VS 




Chapter 6.1. Introduction 


This part of the manual describes how the system programmer may apply 
user-written enhancements or variations, such as user exit routines or 
intitialization overlays, which may be added to CICS/VS code, or, as in 
the case of the DFHTC CTYPE macro instructions, which may alter the 
status of part of the CICS/VS code. 

The information is presented in the following manners 


6 . 2 . 

User Exits for CICS/VS Management Programs - which describes 
the procedures and restrictions for incorporating user-written 
exit routines into CICS/VS management programs. 

6.3. 

User Exits for Asynchronous Transaction Processing - which 
describes the user exits that may be coded when data is 
transferred using the CWTR and CRDR processors during 
asynchronous transaction processing. 

6.4. 

System Initialization overlays - which describes the user- 
written overlays which may be added to the system 
initialization program. 

6.5. 

Modifying The Terminal Control Table - which provides 
information on the DFHTC CTYPE=CHECK, COMMAND, LOCATE, and 
STATUS macro instructions that the system programmer may use to 
modify the status of the terminal control table. 
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Chapter 6,2. User Exits for CICS/VS 

Management Programs 


| This chapter contains information on the conventions and restrictions 
j that must be observed when the system programmer writes a user exit 
j routine for a CICS/VS management program* In addition. Figure 6.2 
| illustrates the contents of the general register and the exit 
| identifications, which the system programmer may require when writing 
| the user exit routine. 

CICS/VS provides a technique for incorporating user-written source 
code into the majority of the CICS/VS management programs. This source 
code may extend various CICS/VS management functions. Provided the user 
conforms to certain restrictions and conventions, this facility should 
minimize the impact of CICS/VS source code modifications when installing 
new releases of CICS/VS. 

I Note : Exit routines may only be written in the macro interface to 
| CICS/VS. User exit routines written in the command interface are not 
j supported. 

To include a user-written exit routine in a particular CICS/VS 
management program, the user must place the source code in a CICS/VS 
source library member (OS/VS) or book (DOS/VS) which has the naming 
convention: 

DFHxxEXT 

where xx is the two-character designation for the management program 
into which the user-written code is to be included. The acceptable two- 
character designations are: 

KC (Task Control) 

SC (Storage Control) 

PC (Program Control) 

TC (Terminal Control) 

FC (File Control) 

IC (Interval Control) 

TD (Transient Data Control) 

TS (Temporary Storage Control) 

TB (Transaction Backout - see "Data Base Backout and Message 

Recovery" in Chapter 4.8.) 

DB (Dynamic Transaction Backout) 

TZ (VTAM Terminal Control) 

The code provided by the user in a given member (book) may consist of 
more than one routine (function), depending upon the number of linkages 
provided in the particular CICS/VS management program. For example, 
file management provides linkage to user-written exit routines both 
before and after an input operation. Thus, user-supplied code in the 
member (book) DFHFCEXT might contain two routines, each identified by a 
unique symbolic name. 

Linkage from the CICS/VS management program to the appropriate user- 
written exit routine is accomplished by one of the following methods: 

1. An assembler BAL instruction that uses the user-defined symbolic 
name as the "branch to" label and general register 14 as a return 
register. 
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2. Register 14 is loaded with an address constant for the user defined 
symbolic name and a BALR 14,14 instruction is issued. 


Note : The user-written exit routines are located at the end of the 

management programs. The length of some programs is such that the exit 
routines are not addressable by the program*s base register(s). This 
situation forces the use of method 2 above, and requires the exit 
routine to establish its own addressability upon gaining control. 


Under method 1, at least some beginning part of the user exit routine 
is addressable by a management program base register. Another base 
register may be required for the rest of the exit routine. 


The symbolic name of the exit routine is specified in the appropriate 
operand when the management program is generated. For example, in 
response to the 


DFHSG PROGRAM=SCP, * 

XTYPREQ=ORANGE 

specification, user exit linkage in the form of an assembler language 
BAL 14,ORANGE 

instruction is generated in the appropriate place in the storage control 
program. In this example, source code similar to the following should 
have been provided by the user in the member DFHSCEXT: 

ORANGE DS OH USER EXIT ENTRY 


User code 


BR 14 

On entry to a user exit routine, registers can be saved in the CSA 
register save area (CSAOSRSA). Using the CSA for register saving is a 
nonreentrant method. The following example shows the use of OS/VS or 
DOS/VS SAVE and RETURN macro instructions to save registers 5 through 9 
and to use register 5 as a base register• 


ORANGE DS OH 

SAVE (5,9) 

BALR 5,0 
USING *,5 


USER EXIT ENTRY 
SAVE REGS 5,6,7,8,9 
IN CSAOSRSA 
USE REG 5 AS BASE REG 


RETURN (5,9) 


RESTORE REGS 5,6,7,8,9 
AND RETURN VIA REG 14 


The exit routine should not issue any OS/VS or DOS/VS macro 
instructions. This includes releasing control to another task which 
might use this same (or another) exit routine. The user must take care, 
however, especially if the routine could lose control to another CICS/VS 
task. 


When creating the CICS/VS management program assembly jobs during 
system generation, a COPY DFHxxEXT statement is included immediately 
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preceding the Assembler END statement. In the above example, the 
following would be generated: 


COPY DFHCSADS 
COPY DFHTCADS 


COPY DFHSCEXT 
END 

When coding user exits for CICS/VS management programs, the user 
should adhere to the following conventions and guidelines: 

1. Because user exits are essentially "in line" with the management 
programs, the programmer should be familiar with the functions of 
the program to which the exit code is being added, 

2. Unless the original contents are restored before return to the 
CICS/VS management program, user-written exit routines must never 
alter the contents of registers that provide addressability to 
control blocks. 

3. User-written exit routines must never violate restrictions of the 
management programs. For example, an exit routine in storage 
control cannot issue a DFHSC GETMAIN request. Exit routines 

| should not issue requests for CICS/VS services. In particular, 

| user exits must not invoke any CICS/VS functions which could cause 

| the task to be put into a CICS wait state. Certain CICS/VS 

| management functions (for example, DFHZCP) rely on not being 

| interrupted during the processing of an item. This restriction 

j usually extends across a user exit. 

4. User-written exit routines must be coded in assembler language. 

5. Symbolic names (labels) used to define user exit entry points must 
not be duplicates of labels in the CICS/VS management program. 

6. Base register addressability for the user-written exit routine 
exists only to the extent of the base register(s) associated with 
the management program. The user exit must never alter the base 
register(s) of the management program. The user is responsible for 
saving registers and establishing addressability. 

7. Register contents differ depending on the management program and 
particular exit function. However, the contents of the following 
registers are always constant: 



14 Return address 

13 CSA address 

12 TCA address 

Depending on the management program and functional user exit, certain 

general registers contain information that the user may find useful. 
Figure 6.2 is a summary, by exit, of the contents of these registers: 
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PROGRAM 

EXIT ID 

LINKAGE LOCATION 

REGISTER 

REGISTER 


DFHDBP 

XINIT 

On entry to 

DBRREG 

Points to record 

(See Chapter 4.4) 

DFHDBP 






XINPUT 

After each log 

DBRREG 






record received (execpt DL/I) 





XFERROR 

Error returned 

DBRREG 

Points to FWA 



from FCP 

FWACBAR 





XDERROR 

On DL/I error 

DBRREG 




DFHKCP 

XDSPCHR 

Before dispatch 

TCACBAR 

Address 

of 

TCA being 





dispatched 



XTYPREQ 

Before request 
analysis 





DFHPCP 

XFETCH 

After load 

PPTCBAR 

Address 

of 

PPT entry 





for loaded 

program 




PCECREG 

Entry point address 
of loaded program 

DFHICP 

XICEEXP 

After expiration 

ICECBAR 

Address 

of 

Interval 



of time interval 


Control 

Element (ICE) 





just expired 


XTYPREQ 

Before request 
analysis 

N. A. 

N. A. 



DFHSCP 

XTYPREQ 

Before request 
analysis 

N. A. 

N. A. 



DFHTCP 

XATTACH 

Before task attach 

TCTTEAR 

Address 

of 

TCTTE 




TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 


XOUTPUT 

Before output event 

TCTTEAR 

Address 

of 

TCTTE 




TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 


XINPUT 

After input event 

TCTTEAR 

Address 

of 

TCTTE 




TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 


XTCMOUT 

Before output event 

TCTTEAR 

Address 

of 

TCTTE 


(TCAM) 

TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 


XTCMIN 

After input event 

TCTTEAR 

Address 

of 

TCTTE 


(TCAM) 

TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 

DFHZCP 

ZATTACH 

Before task attach 

TCTTEAR 

Address 

of 

TCTTE 


(VTAM) 


TIOABAR 

Address 

of 

TIOA 


ZOUTPUT 

Before output event 

TCTTEAR 

Address 

of 

TCTTE 


(VTAM) 


TIOABAR 

Address 

of 

TIOA 


ZINPUT 

After input event 

TCTTEAR 

Address 

of 

TCTTE 


(VTAM) 

TIOABAR 

Address 

of 

TIOA 


Note : For ERASEAUP and READB requests, there is no associated TIOA. 

Figure 6.2 (Part 1 of 2). User Exit Information 
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PROGRAM 

EXIT ID 

LINKAGE LOCATION 

REGISTER 

REGISTER 

DFHFCP 

XOUTPUT 

Before output event 

FWACBAR 

Address of FWA 



FCTDSBAR 

Address of FCT entry 
for target data set 



XINPUT 

Before input event 

FCTDSBAR 

Address of FCT entry 
for target data set 


XINPUTC 

After input event 

FCTDSBAR 

FIOABAR 

or 

VSWABAR 

Address of FCT entry 
for target data set 
Address of FIOA 




Address of VSWA 


XTYPREQ 

Before entry 
analysis 

N. A. 

N. A. 

DFHTDP 

XOUTPUT 

Before output event 

DCTCBAR 

Address of DCT entry 
for target destination 


XINPUT 

Before input event 

DCTCBAR 

Address of DCT entry 
for target destination 


XYTPREQ 

Before request 

DCTCBAR 

Address of DCT entry 



analysis 


for target destination 

DFHTSP 

XOUTPUT 

Before output event 

TSWKREG 

Address of data being 
read or written 


XINPUT 

After input event 

TSWKREG 

Address of data being 
read or written 


XTYPREQ 

Before request 

TSDA 

Address of data area 



analysis 


specified by requesting 
program 

DFHTBP 

XINIT 

During 

initialization 




XINPUT 

After record has 


See "Data Base Backout 



been read from 


and Message Recovery" 



restart data set 


in Chapter 4.8. 


XFERROR 

Error during file 
backout 




XDERROR 

Error during DL/I 




backout 

Note ; CICS/VS provides a set of dummy exit members COS/VS) or books 
(DOS/VS) as part of its distributed source library. They contain only 
dummy labels and a BR 14 instruction, and should be replaced by user- 
written exit routines. 

Figure 6.2 (Part 2 of 2). User Exit Information 
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Chapter 6.3. User Exits for Asynchronous 

Transaction Processing 


| This chapter provides information on the CICS/VS CRDR (input) and CWTR 
| (output) processors, which may be used to transfer data when the 
| asynchronous transaction processing feature of CICS/VS is being used. 

If the asynchronous transaction processing facility is used, the 
CICS/VS-provided input processor (CRDR) and output processor (CWTR) are 
employed to transfer data to and from CICS/VS. The two programs 
accomplish the transfer of data without regard to its content. For 
example, terminal-dependent characters are neither inserted nor removed 
by CICS/VS. 

However, it may be desirable to perform some preprocessing or 
postprocessing on the terminal data. Such processing might be for 
purposes of: 

• Validity and limit checking 

• Removing or inserting device dependencies 

• Summarizing or formatting 

• Providing additional communication with CICS/VS 

These and other services can be accomplished through the use of the 
user exits provided by CRDR and CWTR. When receiving input to CICS/VS, 
CRDR makes each transmitted record available to a user-written exit 
routine immediately after it is received. On output, CWTR offers each 
record to a user-written exit routine immediately after it has been 
deblocked from its transient data input area (TDIA) and is about to be 
transmitted. All records, including delimiter records, are made 
available. 

The exit routine is invoked by specifying its program name suffix in 
the CRDR or CWTR initiating the message. For example: 

CRDR EXIT=MD,NAME=WICHITA 

causes CRDR to load the program named DFHXITMD (where DFHXIT is the 
standard exit routine base name and MD is the suffix) and pass each 
record to that routine while building a batch named WICHITA. 

Similarly, the statement: 

CWTR NAME=FINDLAY,TERMID=(TMLA,TMLB,TMLC),EXIT=DI 

causes CWTR to load the program DFHXITDI and pass each output record 
(associated with the output of batch FINDLAY) to the routine before it 
is transmitted to the terminal. 

One additional point should be noted concerning records given to the 
CWTR exit routine. Messages sent in response to a STATUS request are 
passed to the routine. For example: 

CWTR NAME=SUNYVALE,STATUS,EXIT=CN 

causes the message concerning the status of a batch named SUNYVALE to be 
passed to DFHXITCN. This permits the user-written exit routine to 
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augment the status message. All CICS/VS service macro instructions may 
be used in the exit programs. 


CODING THE CRDR EXIT ROUTINE 

The input processor (CRDR) uses the following basic TCA work area 
definitions: 



COPY 

DFHTCADS 



TWAREC 

DS 

A 

ADDRESS OF RECORD TO 

BE INSERTED 

TWAWA 

DS 

A 

ADDRESS OF USER WORK 

AREA 

TWAIND 

DS 

X 

INDICATORS 


TWAXTRTN 

EQU 

X* 80* 

EXIT PROGRAM RETURN 

INDICATOR 


DS 

3X 

RESERVED 



DS 

20F 

RESERVED 



These fields (plus any additional fields) should be defined by the 
user-written exit routine within the limits specified in the program 
control table (PCT) entry for the routine. Information is passed 
between CRDR and the exit routine by means of this TCA work area. 

Upon initial entry to the exit routine, TWAWA and the TWAXTRTN bit 
are zero. On all entries, TWAREC is zero. All modification of the 
TWAXTRTN bit must be done by either the instruction 01 TWAIND,TWAXTRTN 
or the instruction NI TWAIND,255-TWAXTRTN. The user exit must not 
modify the bits in the TWAIND field used by CWTR. 

On all entries to the exit routine, register contents are as follows: 


Register Contents 


15 

Exit routine 

14 

Exit routine 

13 

CSA address 

12 

TCA address 

8 

TIOA address 

7 

BCA address 


entry address 
return address 

of last message read 


The only registers that cannot be used in the routine are registers 
12 and 13. The other registers are saved before exiting and restored by 
CRDR upon return. The batch control area (BCA) is defined in the 
symbolic storage definition DFHBCADS. (See the appropriate CICS/VS 
Program Logic manual for a description of the batch control area.) 


The exit routine must be enterable at two points. The first entry is 
for routine initialization and is made through an assembler BALR 14,15 
instruction. This is done only once so that turning on the TWAXTRTN bit 
does not cause a reentry to occur. The message in the TIOA is the CRDR 
transaction invoking message. 


All subsequent entries to the exit routine are made through an 
assembler BAL 14,4(15) instruction. This entry is made after each 
message is read. 


The exit routine entry coding might appear as follows: 
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DFHXITAB 

CSECT 



USING 

*,15 


B 

INIT 


B 

MSGP 


DROP 

15 


USING 

• 

DFHXITAB,10 

INIT 

• 

• 

LR 

• 

10,15 

MSGP 

• 

LR 

10,15 


If the record just read is to be accepted without change or is to be 
altered but its length is not to be changed, the record can be processed 
in the TIOA and return made to CRDR through a BR 14 instruction. TWAREC 
and the TWAXTRTN bit should remain zero. 

If the length of the record just read is to be changed, the record 
can be processed in the TIOA by altering the TIOATDL field (if the 
changed record does not exceed the size of the TIOA). TWAREC and the 
TWAXTRTN bit should be zero. If the record is to be lengthened such 
that it will not fit into the TIOA, the record must be built in a user- 
defined work area as a standard variable-length record (VLR)• (The 
record in the TIOA is not a standard VLR because the value in TIOATDL is 
four less than a VLR count.) The address of the count field (LL 1616 ) is 

then put into TWAREC and control is returned to CRDR. 

When the exit routine once again gains control, TWAREC is zero and a 
new message is in the TIOA. A work area used to alter records may be 
defined in the TCA work area or acquired dynamically through a DFHSC 
GETMAIN request. If acquired dynamically, its address may be stored at 
TWAWA. 

To insert records into the input stream, each new record must be 
built in an exit routine work area, its address placed at TWAREC, the 
TWAXTRTN bit set on, and control returned to CRDR. The new record is 

inserted and control is returned to the exit routine with TWAREC set to 

zero and the TWAXTRTN bit unchanged. After all new records have been 
inserted in this manner, the TWAXTRTN bit must be set to zero and 
control returned to CRDR with TWAREC containing zero. The original 
message in the TIOA is placed into the input stream and a new message is 
read from the terminal. 

If the original message in the TIOA is to be deleted, control must be 
returned to CRDR with TWAREC containing the address of F'O*. 


CODING THE CWTR EXIT ROUTINE 

The output processor (CWTR) uses the following basic TCA work area 
definitions: 
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COPY DFHTCADS 
TWANXREC DS A 

TWAREC DS A 

TWAWA DS A 

TWAIND DS X 

TWAXTRTN EQU X'80 f 

DS 3.X 

DS 30F 

These fields (plus any additional fields) should be defined by the 
user-written exit routine within the limits specified in the PCT entry 
for the routine* Information is passed between CWTR and the exit 
routine by means of the TCA work area. 

Upon initial entry to the exit routine, TWAWA and the TWAXTRTN bit 
are zero. On all entries, TWAREC is zero, and TWANXREC points to the 
variable-length record to be transmitted to the output terminal. Any 
modification of the TWAXTRTN bit must be done on a bit level, because 
other bits in TWAIND are used by CWTR. 

The first four bytes of a variable-length record contain a two-byte 
length field and, occasionally, two bytes of control information. In 
the case of the record to be handled by CWTR, the first of these two 
control bytes (byte three of the record) contains the byte that would 
ordinarily be moved to TCTTEOS by the DFHTC macro instruction. The 
second control byte (byte four of the record) applies only to records 
that are destined for a 2260 Display Station (a 3270 operating in 
compatibility mode) or a 3270 Information Display System; this control 
byte corresponds to the TIOALAC or TIOACLCR field. If the destination 
terminal is a 3270 and the TIOACLCR field is not applicable, X f c3'* (the 
default value) must be moved into this control byte. 

If the length of an existing record is to be changed, the two control 
bytes probably are not affected and the information from the original 
record can be used. However, if a new record is built, one or both of 
these control bytes must be constructed. 

On all entries to the exit routine, register contents are: 


lister 


15 

14 

13 

12 

7 


Contents 

Exit routine entry address 
Exit routine return address 
CSA address 
TCA address 
BCA address 


The only registers that cannot be used in the routine are registers 
12 and 13. The other registers are saved before exiting and restored by 
CWTR upon return. 

The exit routine must be enterable at two points. The first entry is 
for routine initialization and is made through an assembler BALR 14,15 
instruction. This is done only once, so that turning on the TWAXTRTN 
bit does not cause a reentry to occur- TWANXREC does not point to a 
message when this entry point is used. 

All subsequent entries to the exit routine are made through an 
assembler BAL 14,4(15) instruction. This entry is made after each 
message is deblocked and is about to be transmitted. 

The exit routine entry coding might appear as follows: 
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DFHXITAB 

CSECT 



USING 

*,15 


B 

INIT 


B 

MSGP 


DROP 

15 


USING 

m 

DFHXITAB,10 

INIT 

m 

• 

LR 

• 

10,15 

MSGP 

• 

LR 

10,15 


If the record about to be written is to be accepted without change or 
is to be altered but its length is not to be changed, the record can be 
processed in its current area* This area is pointed to by TWANXREC. 
Return to CWTR is made with a BR 14 instruction; TWAREC and the TWAXTRTN 
bit should be zero* 

If the length of the record is to be altered, the altered record must 
be built in an exit routine work area as a standard variable-length 
record. The address of the new record must be put into TWAREC and 
control returned to CWTR. The new, altered record replaces the old 
record. When the exit routine once again gains control, TWAREC is zero 
and a new message is pointed to by TWANXREC. 

If both the record at TWANXREC and the new record just described are 
to be inserted into the output stream, the TWAXTRTN bit must be set to 
one prior to returning to CWTR. The new record (pointed to by TWAREC) 
is sent to the terminal and control is returned to the exit routine with 
TWANXREC pointing to the original record; TWAREC is zero. This permits 
the exit routine to continue inserting records into the output stream 
until return to CWTR is made with the TWAXTRTN bit and TWAREC set to 
zero. 

A record can be deleted by returning control to CWTR with TWAREC 
containing the address of F*0 1 . 

If dynamic storage is required by the exit routine, it can be 
acquired from storage control and saved by placing its address into 
TWAWA. 
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Chapter 6.4. System Initialization Overlays 


| This chapter contains information on the conventions and general rules 
| which must be observed when writing CICS/VS system initialization 
| overlays. 

User-written overlays may be added to the system initialization 
program; however, the user is cautioned that the interface to user- 
written overlays is subject to change with later releases of CICS/VS. 

Overlays must conform to CICS/VS naming conventions. All system 
initialization overlays are seven-character names in the format DFHSIxy 
where "x" is a letter from A to Z and "y" is a number from 1 to 9. 
CICS/VS development reserves suffixes which end in 1 (for example, Al, 

B1,...Zl). User overlays may use any other two-character suffix. 

Overlay processing in system initialization is driven from the system 
initialization table SIMODS parameter. User-written overlays may be 
inserted at any point in system initialization processing, but the 
sequence of CICS/VS overlays must not be disturbed. Before attempting 
to add an overlay to system initialization processing, users should have 
a thorough knowledge of CICS/VS internals, be proficient in assembler- 
language coding, and have a reasonable knowledge of the operating system 
they are using. 

Because of the complexity of CICS/VS, various operating system 
considerations, and user needs, it would be impossible to describe in a 
single document all the considerations for coding user overlays. 

CICS/VS is responsible for common subroutine and overlay linkage 
(assuming these routines are not modified), and normal system 
initialization functions. The following are some general rules for 
overlay coding. 

• All overlays must be coded in assembler language. 

• All overlays must copy DFHSIC0M (system initialization common 
area); this provides all system initialization register 
definitions, equates, and DSECTs. 

• All overlays must contain the following two USING statements 
immediately prior to the first executable instruction. 

USING *,SIPBAR2 Establish program addressability 

USING SIPCOM,SIPBARl For common area addressability 

• All overlays must exit through the system initialization overlay 
supervisor. 

• overlays must not exceed 4,096 bytes. 

• The following is a list of system initialization subroutines 
available, and conventions for calling. 
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1. SIPCORE - common storage allocation subroutine 
Calling Sequence 

L SICORA, —F* 500 1 Load storage required 

L SILINKR,SIPCORE Get allocation routine address 

BALR SILINKR,SILINKR Go get storage 

Return Sequence 

Symbolic register SICORA contains the address of acquired 
storage. All other registers are unchanged. 

2. SIPBLDL - common BLDL subroutine 
Calling Sequence 

MVC SILISTID, =CL8'* routine name* Move name 

L SILINKR,SIPBLDL Get routine address 

BALR SILINKR,SILINKR Go to routine 

Return Sequence 

SIPARMP3 - Contains storage required for load module 

SILISTTR - Contains TTRK for load module 

All registers are unchanged except 15. 

3. SIPLDER - system initialization program loader 
Calling Sequence 

Symbolic register SICORA contains storage address to load 
program. 

SILISTTR - Contains TTRK of load module 

L SICORA,=A(load point) Point at place to Load 

MVC SILISTTR,ttrk Move TTRK 

L SILINKR,SIPLDER Get loader address 

BALR SILINKR,SILINKR Go load module 

RETURN Sequence 

) 

Symbolic register SICORA points at load point of program. All 
other registers are unchanged. 

4. SIPOSUP - system initialization overlay supervisor 

Calling Sequence 

L SILINKR,SIPOSUP Get overlay supervisor 

BALR SILINKR,SILINKR Go exit 

Return Sequence 

None, transfer is given to the next overlay of SIP. 

The following areas are always addressable to system initialization 
overlays at entry, and must be addressable at exit. 

• CSA - Common system area 

• SIT - System initialization table 

• SIPC0M - System initialization common area 
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System initialization common routines 




The following fields are supplied as parameter-passing fields between 
user overlays of system initialization. These fields are not to be used 
by CICS/VS overlays. 


SIPARMP6 FULLWORD 
SIPARMP7 FULLWORD 

The DFHWTO macro instruction is provided for use within system 
initialization for conditional write-to-operator functions. If the 
MSGLVL in the system initialization table is one, all messages are 
written; if MSGLVL is zero, none are written. Any messages not to be 
suppressed in CICS/OS/VS should be written by means of the WTO macro 
instructions. The format for DFHWTO is: 

DFHWTO ’MESSAGE UP TO 132 CHAR" 
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Chapter 6.5. Modifying the Terminal Control 

Table 


This chapter provides reference information on the macro and operands of 
the terminal control macro instruction interface (DFHTC CTYPE macros). 
The functions and relevant macro instructions of this interface are: 

• Scanning the terminal control table (DFHTC CTYPE=LOCATE) 

• Changing the status of a logical unit (DFHTC CTYPE=STATUS) 

• Checking the outcome of any of the above operations (DFHTC 
CTYPE=CHECK) 

• Issuing a VTAM indicator (DFHTC CTYPE=COMMAND) 

The DFHTC CTYPE macros should only be used by the system programmer 
when user-specific routines are written to handle recovery and error- 
correction conditions. 

These macros are only available for use with the macro-level 
application programming interface, and only with assembler language. 

A description of the DFHTC CTYPE macros and operands follows. 

Note s The system programmer must specify DFHTCTZE CICSSYST=YES and 
DFHTCA CICSYST=YES in order to generate the system portions of the TCTTE 
and TCA DSECTS, which are required for any program that uses the DFHTC 
CTYPE requests and commands. 


TERMINAL LOCATE FUNCTION -- DFHTC CTYPE^LQCATE 


The DFHTC CTYPE=LOCATE macro instruction may be used by the system 
programmer to: 

• Find the TCTTE for a particular logical unit 

• Retrieve LDC information associated with a TCTTE 

• Scan the TCT from top to bottom 

The locate function allows the system programmer to perform any of 
the above operations without being concerned with the structure of the 
terminal control table. For example, the system programmer can use the 
function to keep track of the availability of certain printers to 
schedule output to them, instead of implementing table-dependent 
application programs to do so. 

Note : Alteration of terminal IDs by the user during CICS/VS execution 

may preclude determining the location at the expected terminal following 
the change. 
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CTYPE=LOCATE 

requests the address of a terminal entry in the TCT and/or the 
address of a LDC entry in the system LDC table. 


ERROR=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if an error occurs. Errors passed to 
this exit routine are those not handled by INVADDR, INVID, 
INVREQ, or INVLDC. 


INVADDR=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if the address specified in TCATPTA is 
not within the limits of the terminal control table, properly 
aligned, or zero for a TERM=NEXT form. This operand is only 
applicable when an address is required in TCATPTA. 


INVID=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if the terminal ID specified in TCATPTA 
is not located in the TCT. This operand is only applicable to 
TERM=ID. 

specifies the entry label of the user-written routine to which 
control is to be passed if the address that was preset in 
TCATPTA was that of the last terminal entry in the table. This 
operand is only applicable to TERM=NEXT. 


| LDC-YES I DEFAULT 

requests LDC information (the mnemonic, the numeric value, 
and/or the entry in the system LDC table or the extended local 
LDC list) associated with a specified TCTTE• If the LDC 
mnemonic is found, CICS/VS returns (in TCATPLDA) the address of 
the LDC entry and (in TCATPLDC), the LDC numeric value. The 
LDC operand causes CICS/VS to search the local LDC table for 
the LDC mnemonic. If the LDC mnemonic is found in the local 
table, the LDC numeric value is supplied from the local table 
(if the local table does not have the numeric value, the LDC 
value is taken from the system table). TCATPTA can be 
preloaded with the address of the TCTTE to be used; if TCATPTA 
is preloaded, the TERM operand cannot be specified in this 
request. This operand does not apply to 3614 logical units. 

Note : If an extended local LDC list exists for the terminal 

specified in the LDC operand, TCATPLDA is set to point to the 
extended local LDC list entry. 
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YES 


indicates that the two-character LDC mnemonic to be used 
has been preloaded in TCATPLDM. If TCATPLDM is set to 
blanks, the default LDC (as explained in DEFAULT below) is 
used; the mnemonic of the default is returned in TCATPLDM 
along with the other LDC information located. If the LDC 
cannot be located, TCATPLDC and TCATPLDA are set to binary 
zeros. 

DEFAULT 

indicates that the default LDC is to be determined for the 
specified TCTTE. The default is the first LDC in the LDC 
list associated with the TCTTE. The default LDC mnemonic 
is returned in TCATPLDM, the numeric value in TCATPLDC, and 
the address of the LDC entry in the system LDC table or the 
extended local LDC list in TCATPLDA. If the default cannot 
be located, TCATPLDM is set to blanks, and TCATPLDC and 
TCATPLDA are set to binary zeros. 


NORESP=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if the required operation was performed 
| successfully. The address of the located terminal entry is 

| returned in TCATPTA. NORESP signifies normal response. 


| TERM=FIRST|NEXT|ID 

indicates which terminal entry is to be located. The terminal 
entry address is returned in the TCATPTA field. 

FIRST 

indicates that the first terminal entry in the table is to 
be located. 


NEXT 

indicates that the terminal entry following that specified 
in TCATPTA is to be located. If field TCATPTA is preset 
with zeros, the first terminal entry will be located. 


ID 

indicates that the terminal entry with the specified 
terminal ID is to be located. Field TCATPTA must be preset 
with the terminal ID (left-justified) and padded with 
blanks (X'*40*) to fill the four-character field. 

Note: If this operand is omitted, it is assumed that the 

request is to locate an LDC, and that an address of a valid 
terminal entry has been preloaded in TCATPTA. 


CHANGING STATUS — DFHTC CTYPE-STATUS 


The DFHTC CTYPE= STATUS macro instruction should be used to perform any 
change of status, instead of directly altering bits in the TCTTE. The 
system programmer should be aware that, when CICS/VS emergency restart 
procedures are invoked following a catastrophic system failure, the 
status of each logical unit is set to the specification given in the 
original terminal control table; this is because none of the dynamic 
changes are retained across the failure. 
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CTYPE=STATUS 

specifies that the status of a logical unit or an LDC is to be 
changed and/or the terminal entry is to be located. 


ERROR, INVADDR, INVID, INVLDC, INVREQ, LASTTRM, and NORESP=symboHe¬ 
address 

are used to test the CICS/VS response to the request for 
STATUS. These operands can be specified in this macro 
instruction or in a DFHTC CTYPE=CHECK macro instruction. These 
operands are defined in the description of the DFHTC 
CTYPE=CHECK macro instruction. See "Test CICS/VS Response to 
CTYPE Requests" which follows. 


LDC=YES 

requests the status change of an LDC represented by the 
specified LDC mnemonic in the system LDC table or in the 
extended local LDC list. TERM= and LDC=YES should be specified 
to change the status of an entry in the extended local LDC 
list; otherwise the system LDC list will be searched. The LDC 
mnemonic is specified in TCATPLDV by the user prior to issuing 
this request. 

The LDC operand can only be specified with PAGE/AUTOPAGE status 
change requests. This operand does not apply to 3614 logical 
units,. 

Note ; If TERM= and LDC=YES are specified, the INVLDC condition will be 
raised if the extended local LDC list does not exist, or if the LDC 
specified does not exist in that list. The system LDC table is not 
searched if TERM= is specified. 


530 


CICS/VS System Programmer’s Reference Manual 






| STATUS=logical-unit-status 

requests that the status of a logical unit or an LDC be 
changed* 

INSRV, OUTSRV, TRANSCEIVER TRANSACTION, RECEIVE, INPUT, NOPOLL, 
PAGE, AUTOPAGE, ACQUIRE, RELEASE, COLD 

indicate the status changes for the specified logical units 
or the LDC* The meanings of these status changes are as 
follows: 

An INSRV (in-service) logical unit is one that can 
either transmit and/or receive data with CICS/VS. 

An OUTSRV (out-of-service) logical unit is one that can 
neither transmit to nor receive data from CICS/VS. 

A logical unit in TRANSACTION status is used in the 
processing of transactions such as inquiries or order 
entries, but cannot receive automatic output* 

A logical unit in TRANSCEIVE status is a TRANSACTION 
terminal to which messages are sent automatically by 
the user. The automatic transaction initiation created 
by a transient data destination reaching a trigger 
level or by a time interval, such as message switching, 
sets a condition in an appropriate terminal control 
table terminal entry (TCTTE)• If the terminal status 
is TRANSCEIVE and if there is no transaction at the 
terminal, terminal control initiates the user-defined 
task. This task is expected to send messages to the 
terminal. 

A logical unit in RECEIVE status is one to which 
messages can be sent but from which no input is 
allowed. 

A logical unit in INPUT status is one which can send 
messages to CICS/VS but cannot receive messages from 
CICS/VS. 

Note : System messages may be routed to an input 

logical unit under conditions such as ATP batch count. 
This causes DFHZNAC to be scheduled. To handle this 
situation, the user should code a node error program to 
perform any user-required action. 

NOPOLL indicates that CICS/VS is no longer to attempt 
to read from the logical unit. 

PAGE indicates that all requests to output data from 
the page supervisor are to be paged, unless specified 
otherwise in the DFHBMS macro or command. When paging, 
the first page from the paging supervisor is written 
when the logical unit becomes available. All 
subsequent pages in a page series are written on 
request of the logical unit (from the operator, if so 
designed) through the use of paging commands.. 

AUTOPAGE indicates that all requests to output data 
from the page supervisor are to be automatically paged 
unless specified otherwise in the DFHBMS macro or 
command. When autopaging, the page supervisor writes 
all pages in a page series automatically. Requests to 
write data directly to the logical unit are not 


Chapter 6.5. Modifying the TCT 


531 



controlled by the PAGE or AUTOPAGE parameters, because 
the page supervisor is not used for direct output. 

Note : PAGE and AUTOPAGE only apply to LDC=YES or to 

TERM=. 

ACQUIRE indicates that the specified logical unit is to 
be acquired from VTAM. 

RELEASE indicates that the specified logical unit is to 
be released to VTAM. 

ACQUIRE* COLD indicates that the specified logical unit 
is to be acquired from VTAM but that message 
resynchronization is not to be attempted with the 
logical unit. This specification is enforced in the 
case of a 3270 Information Display System, the 
interactive logical unit (3767, 3770), and the batch 
logical unit (3770). 


| TERM-FIRST|NEXT|ID 

indicates that a terminal entry is to be located and its status 
changed. If LDC=YES is specified with TERM=, the extended 
local LDC list for that terminal (if located) is changed, not 
the terminal entry. The address is returned in the TCATPTA. 

If both the TERM and LDC operands are omitted, TCATPTA is 
assumed to contain the address of the terminal entry for which 
the STATUS request is being made. 

FIRST 

indicates that the first terminal entry in the terminal 
control table is to be located. 

NEXT 

indicates that the terminal entry following that specified 
in TCATPTA is to be located. If TCATPTA is preset with 
binary zeros, the first terminal entry is located. 

ID 

indicates that the terminal entry with a specified terminal 
ID is to be located. TCATPTA must be preset with the 
terminal ID (left-justified) and padded with blanks (X*40*) 
to fill the four-character field. 

If this operand is omitted, it is assumed that TCATPTA has been 
preset with the address of the terminal entry to be changed. 


TEST CICS/VS RESPONSE TO CTYPE REQUESTS — DFHTC CTYPE=CHECK 

The general format of the DFHTC macro instruction to test the CICS/VS 
response to a preceding DFHTC request for LOCATE or STATUS is: 
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CTYPE=CHECK 

indicates that the CICS/VS response to a DFHTC CTYPE=LOCATE or 
DFHTC CTYPE=STATUS request is to be checked. 


ERROR=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if an error occurs. Errors passed to 
this exit routine are those not handled by INVADDR, INVID, 
INVREQ, or INVLDC. 


INVADDR=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if the address specified in TCATPTA is 
not within the limits of the terminal control table, properly 
aligned, or zero for a TERM=NEXT form. This operand is only 
applicable when an address is required in TCATPTA. 


INVID=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if the terminal ID specified in TCATPTA 
is not located in the TCT. This operand is only applicable to 
TERM=ID. 


INVLDC=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if the LDC mnemonic is not found in the 
system LDC table or the extended local LDC list. This operand 
is only applicable to paging status requests for LDCs. 


INVREQ=symbolic^address 

specifies the entry label of the user-written routine to which 
control is passed if an erroneous bit setting is deleted during 
execution of the macro instruction. 


LASTTRM=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if the address that was preset in 
TCATPTA was that of the last terminal entry in the table. This 
operand is only applicable to TERM=NEXT. 


NORESP=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if the required operation was performed 
successfully. NORESP signifies normal response. 
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COMMAND OPTION FOR LOGICAL UNITS -- DFHTC CTYPE=COMMAND 


The system programmer can use the DFHTC CTYPE-COMMAND macro instruction 
to transmit VTAM commands or indicators from CICS/VS to the logical unit 
application program. The system programmer should use the indicator 
interface to request a VTAM function, rather than directly alter bits in 
the TCTTE, which could lead to unpredictable results if any future - 
changes are made in the TCTTE internal structure. 

r - r - r -—--i 

j | DFHTC j CTYPE= (COMMAND C, WAIT]) | 

| j | t,COMMAND=command] | 

t-L-L-J 

Note : This macro instruction is not valid for VTAM-supported 3270s, and 

| will cause an abend if so used. The macro may, however, be used for 
j 3270 compatibility mode logical units. 


CTYPE =COMMAND 

specifies that a VTAM command is to be transmitted. The 
command is specified in the COMMAND operand. 


| COMMAND=command 

specifies the type of indicator to be sent. The following SNA 
data flow control and session control commands can be 
specified: 

BID 

requests permission to start a bracket for a particular 
TCTTE. CICS/VS uses the BID command as part of the ATI 
process for all logical units which use bracket protocol. 

CHASE 

forces any pending responses to be returned to CICS/VS. 
CLEAR 

resets all sequence numbers to zero, and puts the 
connection in the data flow reset state. No data may be 
sent to, or received from, the logical unit until the SDT 
command has been sent. Only session control commands (STSN 
and SDT) may be sent when the connection is in data traffic 
reset state. 

CANCEL 

requests the receiver to ignore the chained message 
currently being received. 


QEC 

quiesce-at-end-of-chain requests that a logical unit which 
is either out-of-service or in receive-only mode be 
quiesced (but not released from CICS/VS control) following 
the receipt of the message currently being transmitted from 
it. 


QC 

quiesce-complete is used by a node to respond to a QEC 
request to indicate that it is now in quiesce state. 

RQ 

release-quiesce is used by the node that issued the QEC 
request, and removes that node from the quiesce state. 
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SDT 


start-data-traffic removes the specified connection from 
the data flow reset state so that the data and data-flow 
indicators may be sent. 

SIGNAL 

causes an expedited signal to be sent to the terminal 


SHUTD 

shutdown indicates that an end-of-day condition has been 
reached. SHUTD is sent by CICS/VS during termination of 
CICS/VS. 


STSN 

set-and-test sequence number is used during recovery from a 
failure to determine whether any in-flight messages were 
lost. 

VTAM indicators are always sent by CICS/VS with definite 
FME/DRl response protocol requested. DFHZCP calls the 
appropriate routine and returns control to the requestor when 
the response is received. 
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Part 7. Data Set Considerations 




Chapter 7.1. Introduction 


This part of the manual contains reference information on certain 
operations that the system programmer may perform on data sets (files). 

The chapters in this part are: 


7.1. 

Introduction 

7.2. 

Dynamic Open/Close Function - which provides information on the 
DFHOC macro instruction which the system programmer may use to 
examine data sets during the execution of CICS/VS. 

7.3. 

Loading and Accessing Files that use Phonetic Codes for Keys - 
which describes the function that allows misspelled names to be 
used as keys to access data sets. 
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Chapter 7.2. Dynamic Open/Close Function 


| This chapter contains reference information on the DFHOC TYPE-OPEN, 

| CLOSE, and SWITCH macro instructions of the dynamic open/close function. 


The optional CICS/VS dynamic open/close facility allows the user to 
open/close data sets dynamically as often as desired during the real¬ 
time execution of CICS/VS. This makes it possible for the user to defer 
the opening of data sets during system initialization and open/close 
them later as they are needed. The dynamic open/close capability is 
applicable to file management (data base data sets), dump management 
(dump data sets), and transient data management (extrapartition data 
sets) and may be invoked through the master terminal program or through 
the use of the DFHOC macro instruction in an assembler language 
application program. 

The Open/Close macro instruction (DFHOC) is used to request any of 
the following services: 

• Open, close, or switch dump data sets 

• Open or close data base data sets 

• Open or close transient data extrapartition data sets 

Note : The DFHOC macro instruction is intended for use by the system 

programmer as a means of system control; it should not be used by the 
application programmer to open/close data sets, because improper use of 
this macro instruction can cause serious degradation of system 
performance. 


OPENING DATA SETS -- DFHOC TYPE=OPEN 


The programmer can open a data set or series of data sets by issuing the 
DFHOC TYPE=OPEN macro instruction. 



DFHOC j TYPE=OPEN 

j ,DATASET={TRANSDATA|DATABASE|DUMP} 

| [,CHECK=symbolic-address] 

| C,DSETID=(nameC,(xx)],...)] 

j C,LISTADR={YES|(register)|(symbolic-register)}3 
| [,MODE=ICIP|(ICIP,{INIT|DYN>)] 

j (,SYMBADR=symbolic-addressl 


TYPE=OPEN 

specifies that the open function is desired. 


| DATAS ET=r equest 

specifies the type of request, 

TRANSDATA 

indicates a transient data extrapartition data set. 
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DATABASE 

indicates a data base data set. 


DUMP 

indicates a dump data set. 


CHECK=symbolic-address 

specifies the symbolic address of a user-written routine to 
which control is passed if any error is detected during the 
OPEN operation. The user-written routine is given control 
whenever TCAOCTR in the TCA contains a non-zero return code. 

It is the responsibility of the user to examine the return code 
in the TCA and, if necessary, examine the individual error 
codes in the list that was built either by the user or by the 
expansion of the DFHOC macro instruction. The error code 
appears in the first byte of the third word of each entry in 
the parameter list. 

Upon return from the dynamic open/close program, TCAOCTR may 
contain one of the following hexadecimal codes: 


00 - No error 

FF - Invalid request 

or, if TCAOCTR contains neither of these codes, it will contain 
one or more of the following hexadecimal codes: 


80 - Open error 
40 - Close error 

20 - No space available for OPEN 
10 - Invalid control block name 

While performing the requested service on the list of data 
sets, the individual error bytes in the list entry are filled 
either with a hexadecimal 00 or with the proper error code each 
time an error is encountered. If more than one error is 
encountered while processing the parameter list, TCAOCTR 
reflects all the errors and perhaps a bit configuration 
different from those shown above. For example, there are six 
data sets to be opened; if four are successfully opened, and 
one has an invalid control block identification, and the other 
one has an open error, the TCAOCTR field contains a hexadecimal 
90. 

When there is insufficient storage available to open any data 
sets, TCAOCTR contains a hexadecimal 20, and all the entries 
contain a fullword (four bytes) of zeros in the third word. 


DSETID=name 

specifies the data set names or destination identifications to 
be used in constructing a parameter list. If a suffix is 
specified, it must be separated from the name or destination 
identification by a comma and must be enclosed in parentheses. 
This operand is not applicable if DATASET=DUMP is coded or if 
LISTADR or SYMBADR is used. 

If DATASET=DATABASE is coded, as many as 255 data set names can 
be specified with a single use of the DSETID operand. If 
DATASET”TRANSDATA is coded, up to 255 transient data 
destination identifications can be specifed with a single use 
of the DSETID operand. If TYPE=OPEN is coded and if the 
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destinations are nonresident, "xx," a two-character suffix of 
the data set control block (DCB for CICS/OS/VS, DTF for 
CICS/DOS/VS) must be provided with each destination 
identification; if the destination is resident, the "xx" suffix 
is ignored. 

In CICS/OS/VS, if "xx" consists of more than two characters, it 
is assumed to be the symbolic address of a list of options and 
parameters to be moved into the DCB. For the format of this 
list, see the discussion of the LISTADR operand in this 
section. 


| LISTADR=YES|register|symbolic-register 

specifies the address of the open/close parameter list built by 
the user. 

YES 

indicates that the address of the parameter list has been 
placed in the TCA at TCAOCLA. 

register 

indicates the register containing the address of the 
parameter list. 

symbolic address 

indicates the symbolic register name containing the address 
of the parameter list. 

This operand is not applicable if DATASET=DUMP is coded. If 
the LISTADR and SYMBADR operands are omitted, execution of the 
DFHOC macro instruction causes the list to be built for the 
user starting with the first byte of the TWA. In this case, it 
is the user*s responsibility to make sure that the required 
space is available in the TWA. The space can be calculated 
using the formula: 


Space = (n x 12) + 4 

where "n" is the decimal number of 12-byte entries in the 
open/close parameter list and the "4" represents four bytes of 
hexadecimal Fs to signify the end of the parameter list. 

The symbolic storage definition (DFH0CLDS) of a parameter list 
entry is provided by CICS/VS. The format of 12-byte entry in 
the open/close parameter list is: 


TRANSDATA 

WORD 1: Four-byte destination identification. 

WORD 2: Four bytes of the form bbxx, where 1616 is two 

bytes of blanks and xx is a two-byte suffix of 
the data set control block created by the DCT 
assembly. 

WORD 3: Error byte plus three-byte address of DCT entry 
(after completion). 

DATABASE 

WORDS 1 and 2: Data set name (left justified, padded with 
blanks). 

WORD 3: Error byte plus three-byte address of FCT entry 
(after completion). 
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Note: The parameter list must be terminated by a hex •FF•. 

In CICS/OS/VS, the user can optionally specify, in WORD 2 of a 
TRANSDATA entry, the parameter list address pointing to a 
storage area. This storage area contains information to be 
placed into a dummy DCB before opening it,* If an address is 
placed in this field, the first byte must be set to a 
hexadecimal FF. The symbolic storage definition (DFHOCODS) of 
this parameter list is provided by CICS/VS. The format of the 
parameter list is as follows: 


Byte 1: 
Byte 2: 
Byte 3: 
Byte 4: 
Bytes 5,6: 
Bytes 7,8: 


Open options byte 
BUFNO byte 
RECFM byte 
ERROPT byte 
LRECL 
BLKSIZE 


Bytes 9-16: DDNAME 


The first eight bytes must contain the correct hexadecimal 
codes for the desired parameters, since the 16 bytes of the 
open/close parameter list are moved into the DCB. 


| MODE=ICIP|INIT|DYN 

allows the user to specify further options associated with the 
opening of files. This operand applies only to ICIP and mixed 
mode data base files, and is ignored for other types of files. 
The following operands may be used when MODE is specified: 
TYPE=0PEN, DATASET=DATABASE, DSETID=(NAME,...), and 
CHECK=symbolic address. 

ICIP 

indicates that all ICIP and mixed mode files in the DSETID 
list will be opened in ICIP mode. If ICIP is not 
specified, the MODE option is ignored. 


INIT 

specifies that the in-core indexes are to be built during 
OPEN processing. This is the default specification. 


DYN 

specifies that the in-core indexes will be built 
dynamically when the index control intervals are referenced 
during GET processing. Note that if MODE is not specified 
or is ignored in a DFHOC macro, the following defaults will 
apply: 


1. Mixed mode files will be opened in VSAM mode. 

2. In-core indexes for ICIP files will be built during OPEN 
processing. 

Note : This operand will override the option specified in the 

MODE= operand of DFHFCT TYPE=DATASET macro instruction. 
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SYMBADR=symbolic-address 

indicates the symbolic address of an open/close parameter list 
built by the user. If the SYMBADR and LISTADR operands are 
omitted, execution of the DFHOC macro instruction causes the 
parameter list to be built for the user starting with the first 
byte of the TWA. For a discussion of the parameter list, see 
the discussion of the LISTADR operand in this section. This 
operand is not applicable if DATAS ET= DUMP is specified. 


CLOSING DATA SETS — DFHOC TYPE=CLOSE 


The programmer can close a data set or series of data sets by issuing 
the DFHOC TYPE=CLOSE macro instruction. The DATASET, LISTADR, SYMBADR, 
and CHECK operands have the same significance as in DFHOC TYPE=OPEN. 

r-r-r- 

| j DFHOC j TYPE=CLOSE 

| | j ,DATASET={TRANSDATAJDATABASE| DUMP} 

j j j [,CHECK=symbolic-address] 

j | j C,DSETID=(name,...)] 

j | j l,LISTADR=CYES|(register)|(symbolic-register)>3 

| | | t,SYMBADR=symbolic-address] 


TYPE=CLOSE 

specifies that the close function is desired. 


DSETID=name 

specifies the names of the data sets to be closed. No suffix 
is required. As many as 255 data set names can be specified 
with a single use of this operand. 

The DATASET, CHECK, LISTADR and SYMBADR operands are as described above 
in the DFHOC TYPE=0PEN macro instruction. 

Note : If a data set is being accessed by other transactions when it is 

closed, the other transactions may be abnormally terminated. 


SWITCHING DUMP DATA SETS — DFHOC TYPE=SWITCH 


The programmer can switch from the dump data set currently being used to 
the alternate dump data set by issuing the DFHOC TYPE=SWITCH macro 
instruction. This macro instruction causes the current dump data set, 
if open, to be closed, and the alternate dump data set to be opened, A 
TYPE=CLOSE,DATASET=DUMP macro instruction does not cause a switch but 
only closes the current dump data set. 


j DFHOC | 

TYPE=SWITCH 

1 1 

, DATASET-DUMP 


TYPE=SWITCH 

specifies that the switch function is desired. 
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DATASET=DUMP 

specifies that the dump data set is to be switched. 
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Chapter 7.3. Loading and Accessing Files that 

use Phonetic Codes for Keys 


| This chapter explains how the DFHPHN macro instruction is used, and 
| should be read in conjunction with the section on built-in functions in 
| the appropriate CICS/VS Application Programmers Reference Manual , 

The major use of phonetic codes is for keys to data sets. In this 
way, records can be accessed even though the key may be misspelled. The 
phonetic code conversion subroutine (DFHPHN) is provided to assist the 
user in loading and accessing such data sets offline. DFHPHN is 
generated by specifying the CICS/VS built-in functions program DFHSG 
PROGRAM=BFP (CICS/OS/VS only). For CICS/DOS/VS, DFHPHN must be 
assembled by the user. 

This offline subroutine provides the facility to convert a 16- 
character name to a four-byte phonetic code. See the Built-In Function 
macro instruction (DFHBIF TYPE=PHONETIC) in the CICS/VS Application 
Programmers Reference Manual (Macro Level) for the rules of the 
conversion. 

This function can be invoked by a program running under any of the 
operating systems under which CICS/VS can be run. The calling format 
is: 


CALL DFHPHN,(lang,name,phon> 

CALL DFHPHN (lang,name,phon) 

CALL •DFHPHN 1 USING lang name phon 

where: 


Assembler 

PL/I 

COBOL 


lang 

is the symbolic address of a field which contains a one- 
byte language indicator. 

If an error occurs during processing of this request, X*50* 
is returned in this location. If no error occurs, X*00* is 
returned and the location must be reset to indicate the 
programming language before the location can be reused. 


X*FO * indicates assembler or COBOL 

X•Fl* indicates PL/I 


name 

is the symbolic address of a field which contains the 16- 
character name. 


phon 

is the symbolic address of a field in which the 4-byte 
phonetic code is returned. If the first character of the 
| "name" field is not alphabetic (A to Z), the "lang" field 

will be set to X* 50 ". 

The steps in loading such a data set would typically be: 

1. Create the keys. 
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a. Read a record from the source data set. 

b. Generate the code through a call to the DFHPHN subroutine. 

c. Write the record on a temporary sequential data set. 

2, Sort the temporary data set on phonetic code. 

3. Load the key-sequenced VSAM data set. 

a. Read the sorted temporary data set. 

b. Write to the keyed data set. 

Note that sorting on phonetic key will not produce the same order as 
sorting on name, and that there is a high probability of duplicate 
phonetic keys. 
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Part 8. Host Processor Resource Estimation 




Chapter 8.1. Introduction 


| This section of the manual describes simple techniques and provides 
approximate data to allow the system programmer to estimate the amounts 
| of the main resources in the host processor that are necessary to run a 
CICS/VS system. These resources are: 

| • The processor 

• Virtual Storage 

| • Real storage (reference set storage) 

| • The I/O devices 

They are discussed in subsequent chapters in this part of the manual. 

| Furthermore, each chapter contains a number of tables that provide data 
j about CICS/VS functions to allow the user to estimate the usage of these 
j resources. Chapter 8.6 discusses how to use the estimates of the 
j various resource requirements to estimate approximate response times and 
j maximum loadings of the host processor. No attempt is made to provide 
j data or techniques to estimate total system response, maximum loading, 
j resource estimates of other resources (for example, communication 
j lines), or to estimate host processor resource utilization by other 
j applications (for example, batch or TSO). Chapter 8.7. gives examples 
j of the use of the data and of the estimating techniques. 

| In order to accomplish the above objectives, it is essential that the 
j system programmer has equivalent information about the major application 
j programs used in the CICS/VS system. 

| Further information on the performance aspects of CICS/VS can be 
j found in the CICS/VS System/Application Design Guide and in the 
j appropriate CICS/VS System Programmer* s Guide. . 

| The information presented in this manual should assist the reader to: 

| • Estimate the host processor requirements for the CICS/VS system 

| • Estimate upper and lower limits of response and maximum load in the 

j host processor 

• Evaluate function/performance/cost tradeoffs during the system and 
application design processes 

| • Estimate the ability of the host processor to support expansion of 

the existing system. 

| Although it is believed that the data given in the following chapters 
j is correct, and that the estimating techniques are valid, no guarantee 
j is given that any data or anv of the techniques described will give an 
j accurate result for any given system . 
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Chapter 8.2. Host Processor Utilization 


This chapter contains advice on how to estimate the host processor 
utilization for a CICS/VS system. Processor utilization can be defined 
as the ratio of the time that the processor is busy (in a particular 
period) to the length of the period. The result is often expressed as a 
percentage. 

In practice, for a given set of transactions in a given system, the 

processor utilization is a complex function of the transaction rate. 

However, in most cases it has been found that over a reasonable range of 

transaction rates the curve can be approximated by a straight line of 

the form: 


U= A + BR ...Equation 1 

where "A* and "B" are constants, "R" is the overall transaction rate per 
second, and "U" is the utilization expressed as a value between 0.0 and 
1 . 0 . 

Figure 8.2 shows an example of a real curve and an approximation of 
the processor utilization. In some cases, where there is a wide range 
of transaction rates under consideration, a better approximation can be 
obtained by using more than one straight line to fit the real curve for 
different ranges. However, in practical cases the transaction rates of 
interest are usually in a small enough range to give satisfactory 
results with only one straight line. 

The System/370 range of processors on which CICS/VS is run extends 
from the model 115-0 to the 3033. The fastest machine in the range (the 
3033) will, on average, execute instructions about 90 times faster than 
the model 115-0. However, it should be remembered that, because of 
differences in the design of the processors, the ratio in speeds for 
any two processors will vary according to the type of instruction 
executed. 

For CICS/VS systems, it has been found, over a wide range of 
transactions, that it is a reasonable approximation to multiply the time 
taken to execute the instructions necessary to perform any particular 
transaction on one processor and to multiply it by a common factor, 
which is independent of the transaction, to obtain the time on a 
different processor. 

If a particular processor is taken as a standard, a set of factors 
(refered to in this manual as the Relative Power Factors (RPF)) can be 
used. A table of these factors (Table 4) is given later in this 
chapter. 

For convenience, the standard chosen is a hypothetical processor 
whose RPF is 1000. All times used in this chapter are in milliseconds 
and are "measured" on the hypothetical processor whose RPF is 1000. 
Hence, to convert from the time on the hypothetical processor to the 
time on a real processor, any result should be multiplied by 1000/RPF. 
For example, if the time required a transaction required on the 
hypothetical standard processor was 300 milliseconds, the time on a 
System/370 model 145 (whose RPF=350) would be: 
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| 300 x 1000 

I 350 


I - 857 milliseconds 



| Figure 8.2, Processor Utilization against Transaction Rate 

| The calculation of the host processor utilization based on this 
| approximation is done in various stages, as follows: 

| 1. Identify the most frequently used transactions, itemize both the 

| CICS/VS functions used and the number of times they are called in 

j each transaction invocation, and define or measure the transaction 

j rate for each transaction• 


554 CICS/VS System Programmers Reference Manual 



2. Calculate the processor "busy time" for each of these transactions, 
using the table of timings given later in this chapter, 

3. From a knowledge of the transaction rate and the processor busy 
time of each transaction, calculate the processor utilization for 
each transaction type. This processor utilization is then to be 
converted to the utilization that would occur on the real machine. 
The average value taken over all the transactions is the constant 
"B" in Equation 1. 

4. Calculate the processor utilization that is taken up by CICS/VS and 
by the operating system independently of any particular 
transaction. This is the constant "A" (see Equation 1) and is 
called the background processor utilization . This should not be 
confused with instructions executed by the background partition in 
DOS/VS systems. 

5. The results of (3) and (4) are summed to give the total processor 
utilization taken up by CICS/VS and the application programs. If 
other subsystems (for example, batch) are running in the same 
processor, these must be estimated separately. 

Each stage is discussed in the sections that follow. A detailed 
example is given in Chapter 8.7. 


DEFINING THE TRANSACTIONS AND TRANSACTION RATES 


A CICS/VS transaction can be divided into two parts: 

• BASE (or system) part 

• Application-dependent part 

The BASE (or system) part involves initialization and termination of 
the transaction, and the application-dependent part contains the CICS/VS 
macros or commands issued by the application program, together with the 
application code itself. Each CICS/VS function used should be 
tabulated, together with the number of times it is used in each 
transaction. 

Three major types of transaction exist, which are used to 
characterize the BASE transactions. These types are: 

• ECHO, which consists of accepting input from a terminal, initiating 
the transaction, sending the reply or "echo" back to the same 
terminal immediately, and terminating the transaction. 

• Conversational ECHO, in which a conversation is held between the 
terminal and the application program involving several inputs and 
the same number of outputs. From an estimating point of view, the 
total transaction is split into several "conversational echos" each 
consisting of one input, reactivation of the dormant transaction, 
and outputting the reply, together with any other processing 
necessary before the next input. 

• Automatically initiated BASE transactions, which are initiated by 
means other than a terminal input, are classified separately. They 
consist of the initiation process (for example, time initiation) 
and the termination process. The BASE part is assumed not to 
include any communication with a terminal. 
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The main transactions in a system are either definable (during system 
design) or can be identified by an analysis of a running system by using 
such tools as CICS/VS statistics or the CICS/VS Performance Analyzer, 
Similarly, the individual transaction rates can be obtained. Each 
transaction type should then be analysed to find the BASE type and the 
application-dependent functions used in the transaction. Having done 
this, the next step is to calculate the time taken by the processor to 
execute the transaction instructions. 


CALCULATING TRANSACTION EXECUTION TIMES 


A first approximation to the processor busy time (P) of a CICS/VS 
transaction can be represented by: 

P= a Q ♦ a<L + bL + cT + dT/L ... Equation 2 

where: 

"a Q " , m a± m , "b", "c", and "d" are constants for a given system 

and 

"L” and "T" are the total number of lines and terminals 
attached to the system. 

The term "a 0 " is the BASE component and "ai" is the sum of 
contributions from the application-dependent part. Values of "a 0 " and 
"a*" can be obtained from data in Tables 1 and 2 respectively. The time 
taken to execute the application program itself, on the hypothetical 
standard processor, must be added to the "a*" value. 

This application value can be found by several means, as follows: 

• Estimate or measure the application pathlengths, divide the answer 
by 1000, and add the result to the "a*" value. 

• Or: measure the times by using a hardware monitor, and convert 
these to standard processor times by using the RPF values in Table 
4. The result is added to the n a±" value. 

• Or: make a crude estimate as follows? 

for applications that do little else other than call CICS/VS, 
add 5% to the "at" value 

for other applications, add 10% to the "a*." value 

The appropriate BASE and application functions for each transaction 
are selected as described in "Defining the Transactions and Transaction 
Rates”, and a total of the "a 0 " and "a*." values is obtained for each 
transaction. 

The network component of the execution time bL ♦ cT ♦ dT/L, which is 
part of the BASE component, is then calculated. The constants "b", "c", 
and "d" are functions of the TP access method, terminal type, and 
release of CICS/VS. Values for these constants are given in Table 3. 

The result will be in milliseconds. 

When network components have been obtained for each transaction, they 
should be added to the "a" values obtained to give the total time. 

Where there is additional terminal I/O besides that of the BASE 
component, an additional network component should be added at the rate 
of one half the original network component value for each additional 
I/O. The timings should then be tabulated for each transaction type. 
Refer to Chapter 8.7. for examples. 
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CALCULATING TRANSACTION PROCESSOR UTILIZATIONS 


The timings for each transaction should now be converted to "time per 
second" by multiplying each transaction time by the individual 
transaction rates for each transaction. The results should then be 
summed over each transaction to give a total value for the busy time per 
second on behalf of all the transactions. 

As discussed above, each processor type is characterized by a 
processing power expressed relative to the power of the " hypothetical 
standard processor " executing a dedicated CICS/VS system. For 
convenience, the power of the "hypothetical standard processor" is taken 
as 1000. Values for the range of System/370 processors are given in 
Table 4. 

It has been observed that wide variations of execution speed can 
occur for different types of programs. However, for a wide range of 
CICS/VS programs, the variation in execution speeds is sufficiently 
small to enable a single average value to be used for a particular 
processor. These values are shown in Table 4. No guarantee is given 
that the relative values in Table 4 will represent any particular 
environment and they should not be assumed to represent any system other 
than one that is dedicated to CICS/VS . 

From this table, the appropriate relative processing power factor is 
selected. The total busy time per second is then divided by the 
relative power to give the processor utilization term "BR" in Equation 

1 . 


Hence, if there are " k " transactions and ” P« "is the processor 
busy time of the “jth " transaction and " Rj " is the transaction rate 
of the same transaction, "BR" is given by: 


BR = (1/F) C + P 2 R 2 + «..P* R* + ...Equation 3 

where: 


"F" is the processor relative power factor 
"R" is the total system transaction rate 


CALCULATING THE BACKGROUND PROCESSOR UTILIZATION 


| Background processing occurs primarily because CICS/VS periodically 
j scans terminal control tables and wait lists to see if any work is to be 
I initiated, other instructions may also be executed because the 
| operating system also periodically scans tables. Note that the term 
j "background processing" should not be confused with batch jobs executing 
j in the DOS/VS background partition. 

| However, because it is the purpose of this estimating technique to 
j use the straight line approximation (see Figure 8.2) it is necessary to 
j use the value "A" rather than the actual value "A*". 

| However, both "A" and "A*" are dependent on the operating system, the 
j network size, and the CICS/VS ICV parameter specified in DFHSIT. 

| An appropriate value for "A" can be calculated as follows: 
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• Calculate the processor time (P) to execute an ICV interrupt from 
the equation: 

P= X + YL + ZT + V ...Equation 4 

where "L" and "T" are total numbers of lines and terminals 
and "X","Y", n Z", and "V" are constants given in Table 5, at the 
end of this chapter. 

If "F" is the relative processor power in Table 4, and ICV is the ICV 
value in milliseconds, M A" is given by: 


A= 1000P/(ICVxF) ...Equation 5 

For most systems this value should lie between 0 and 0.05 (that is 
5%). If an OS/VS system is being used, the operating system makes 
another contribution to the "A" value. An estimate for an OS/VS2 
Release 2 and later (MVS) system is 0.002 (0.2%) per address space. No 
measured figures are available for OS/VSl, but a value of 0.01 to 0.02 
(between 1 and 2%) should be taken. 


TOTAL PROCESSOR UTILIZATION 


The "A" and "BR" values calculated in the previous section are added to 
give the total processor utilization due to CICS/VS. If other jobs are 
running in the same processor (for example, batch, IMS/VS), allowance 
must be made for the processor utilization of these items. 

Until now it has been implicitly assumed that the number of page- 
fault I/Os is close to zero. Although it is relatively easy to 
calculate the increase in processor utilization when the number of page- 
faults that occur per second or per transaction is known, no simple 
technique has been found to calculate the number of page-faults that 
will occur in any situation. The only reliable technique is to measure 
the number of page-faults and then to estimate the processor utilization 
for various numbers of page-faults to investigate the relative effect on 
the overall processor utilization. 

In practice, although a processor utilization in excess of 95% can be 
achieved, it is preferable to assume that 80% will be the upper limit, 
to preserve reasonable response times. Reference should be made to 
Chapter 8.6 for further discussion on this subject. 


TABLES 

The tables given in this section are: 

• Table 1 - CICS/VS BASE transaction timings 

• Table 2 - CICS/VS application function timings 

• Table 3 - CICS/VS network component timings 

• Table 4 - System/370 processors - relative power factors 

• Table 5 - CICS/VS background timings 

The following notes apply to all the tables: 
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• All timings are in milliseconds "measured" on the standard 
processor. 

| • All timings are approximate. They are intended to represent medium 

size installations in normal situations running applications of 
average complexity. Where systems are generated to include all 
functions, and where the data base structure is very complex, 

| timings will be higher than those quoted. For small simple 

| systems, timings can be less. A sensible level of tuning is 

assumed, that is to say, the system programmer should be familiar 
with the information in the appropriate CICS/VS System Programmer 1 s 
Guide and should have put the more significant guidelines into 
action. 

• Timings represent the current release of CICS/VS unless 
specifically stated otherwise. 

• Items marked "—■ indicate that reliable data is not yet available. 

• Items marked "NA" indicate that the particular function does not 
exist (for example, VSAM ICIP under DOS/VS). 


TABLE 1. 


r * ' 

| Transaction Type | 

DOS/VS | 

OS/VS1 | 

OS/VS2 (MVS) 


1 ECHO | 


1 

1 



| BTAM 3270 BSC | 

22.0 

22.5 | 

25.0 


| 3270 Loca; | 

10.0 

14.5 | 

16.0 


j Start/Stop | 

19.5 

j 

- 


| Start/Stop point-to-point | 

14.2 

| 



| VTAM 3270 Local | 

17.5 

22.0 | 

20.0 


| 3270 BSC | 

18.5 

22.4 | 

23.0 


| 3270 SNA (3274/3278) | 

15.0 

18.0 | 

20.0 


j 3600-SNA | 

15.0 

18.0 | 

20.0 


j 3790-SNA 1 - | 

20.0 

28.8 | 

— 


j 3790-3270 emulation 1 - | 

21.0 

27.6 | 

— 


| Authorized Path VTAM + CICS/VS | 

NA 

1 

NA | 

12.5 


| HPO (3600, 3270 SNA) | 


i 

i i 



j Primed storage - deduct from j 

NA 

I 

• 

O 

i 

• 

o 


j all ECHO values | 


1 

i 



I Conversational ECHO 1 

1 1 

—USE ECHO VALUES— 

i i 


1 Automatic Initiation 1 

4.5 

1 

4.9 | 

i 

5.2 




1 


-J 


Table 1. Base Transaction Timings (in milliseconds) 


Notes : 

1. Includes processing of mandatory definite response from 3790 when 
CICS/VS sends End Bracket on the (last) write. 
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2. All values given assume the ECHO is written in assembler (Macro 
Level), occupies the first position in the program control table, 
and is resident in virtual storage. 

The CICS/VS application function timings given in Table 2 (below) are 
in milliseconds and represent "average" systems. Variations will occur 
because of different options in the operating systems, access methods, 
CICS/VS, and with the size of the installation. Hence, all values are 
approximate but are believed to be individually correct to within plus 
or minus 10% for the majority of configurations. 

The timings given represent CICS/VS Version 1, Release 4, unless 
otherwise stated. 

The "NA" symbol indicates that the pathlength data is not applicable 
to a certain function, and indicates that information is not yet 
available for that function. 

No guarantee is given that these timings accurately represent any 
particular environment. 
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| TABLE 2 


r---- — -- 

| Application Function 


DOS/VS I OS/VS1 1 OS/VS2 
(Times in milliseconds) 


r .. . "" " .". " L “ " J .-. 

1 Terminal Control 




i 

i 

i 


| BTAM 3270 Local READ 


3.4 

| 5.1 

1 


j WRITE 


3.5 

| 3.7 

| 


j 3270 BSC READ 


6.1 

| 5.6 

| 


j WRITE 


10.3 

| 9.2 

j 


j VTAM 3270 Local READ 


7.1 

1 9.7 

| 6.7 


j WRITE 


6.4 

| 8.9 

| 7.0 


| 3270 BSC READ 


7.5 

| 9.0 

| 8.0 


| WRITE 


5.4 

| 6.3 

I 7 - 7 


j 3270 SNA READ 


7.0 

| 7.5 

1 7 - 7 


j WRITE 


4.7 

| 6.0 

| 6.2 


j 3790 READ 


7.0 

1 7.5 

1 7 * 7 


| WRITE 


4.7 

| 6.0 

| 6.2 


j 3600 READ 


7.0 

1 7 -5 

| 7.7 


j WRITE 


4.7 

| 6.0 

| 6.2 

1 


| VPACING RESPONSE*- 


2.8 

| 3.7 

I 

| 4.2 


j PUNSOL=YES (L3270 and 


2.0 

| 2.3 

| 2.5 


| BSC only) 




1 


| RESPONSE to input data 


4.2 

1 5.5 

j 5.7 


j RESPONSE from terminal 


4.7 

| 5.8 



i Deduct for authorized path 2 




i 

i 


| READ 


NA 

| NA 

1 -2.0 


j WRITE 


NA 

| NA 

1 -I* 7 

i 


| MSGPREQ=PROTECT (PCT) 




I 


j Add to ECHO (VTAM only) 


— 

| 27.0 

1 


1 Basic Mappinq Support 




1 


|(excluding terminal I/O pathlengths) | 

i i 



i 

i 


I output - DATA=YES BASE 

i 

i 

1.5 

1 1-7 

| 1.7 


j Add (per field) 

i 

0.12 

| 0.12 

| 0.12 


| Subtract (per null Field) 

i 

i 

-0.05 

| -0.05 

| -0.05 


| DATA=ONLY BASE 

i 

i 

1.5 

1 l- 7 

1 

1 l- 7 


j Add (per field) 

i 

0.035 

| 0.035 

| 0.035 


| Add (per DATA field) 

i 

0.08 

| 0.08 

| 0.08 


j Subtract (per null DATA 

i 

-0.05 

| -0.05 

| -0.05 


| field) 

i 

a 



I 

i 


| DATA=NO BASE 

I 

1.3 

| 1.5 

1 1.5 


j Add (per field) 

1 

0.07 

| 0.07 

| 0.07 


j Add (per FORMAT field) 

1 

0.05 

| 0.05 

| 0.05 


j Primed storage - deduct 

1 

NA 

| 0.2 

| 0.2 


j from BMS BASE 

a 



1 

1 


| Input (TYPE=MAP or TYPE=IN) 

1 

1 



I 

1 


| BASE 

1 

1.8 

| 2.0 

| 2.0 


Add (per changed field) 

1 

0.12 

| 0.12 

J 0.12 


| Primed storage, deduct BASE | 

« i 

NA 

| 0.3 

| 0.3 

1 


i 

1 



1 

•J 


Table 2. (Part 1 of 5) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 


Chapter 8.2. Host Processor Utilization 


561 









r 

Application Function 

| DOS/VS 
| (Times 

1 

in 

OS/VS1 1 OS/VS2 
milliseconds) 


r 


1 

1 





Map location (excluding PPT search) 

1 

1 

1 





Resident in virtual storage 

| 0.25 

1 

0.25 

| 0.25 



Not resident in virtual 

| 3.5 

1 

7.0 

| 8.0 



storage 

i 

I 

1 

1 





Proqram Control 

1 

1 

l 

1 

1 

1 





a) Resident programs and maps 

1 

i 

1 

1 





(and non-resident programs and 

i 

1 





maps already in core) 

i 

1 





LINK+RETURN 

| 0.42 

1 

0.42 

0.42 



XCTL 

| 0.12 

1 

0.12 

| 0.12 



LOAD 

| 0.25 

i 

1 

1 

0.25 

| 0.25 



b) Non-resident programs and maps 

1 

1 

1 





LINK*RETURN 

| 2.4 

1 

7.4 

| 8.4 



XCTL 

| 2.1 

1 

7.1 

| 8.1 



LOAD 

| 2.0 

1 

7.0 

| 8.0 



DELETE 

j 

1 

- 

1 



(These exclude the PPT search - see 

1 

1 





Table Search pathlengths, below) 

1 

1 

1 

| 





c) High-level language support 

1 

1 

1 

1 





(macro level) 

| 

1 





PL/I per program called 

1 1 -1 

1 

1.1 

1 1-1 



per macro call 

| 0.02 

1 

0.02 

| 0.02 



COBOL per program called 

| 0.45 

1 

0.45 

| 0.45 



per macro call 

| 0.04 

i 

1 

1 

0.04 

| 0.04 



d) Command-level language support 

1 

i 

1 

1 





These timings should be added 

i 

1 





to the macro level timings for 

i 

1 





the same language. For RPG II add 

i 

1 





to assembler data. 

i 

1 





PL/I ECHO 

| 1.3 

1 

1.3 

| 1.3 



BMS 9 

| + 2056 

1 

+ 2056 

| +20% 



Other calls 

| +10% 
f 

1 

1 

+1056 

| +10% 



Assembler ECHO 

I 

| 1.3 

1 

1.3 

| 1.3 



BMS 9 

| *15% 

1 

+ 1556 

| +15% 



Other calls 

| +156 

t 

1 

+1- 

| +1% 



COBOL ECHO 

1 

| 2.8 

1 

1 

2.8 

J 2.8 



BMS 9 

| +2556 

1 

+ 2556 

| +25% 



Other calls 

| +656 

1 

+656 

| +6% 



RPG II ECHO 10 

| 11.0 

1 

1 

NA 

| NA 



BMS 

| +1556 

1 

NA 

| NA 



Other calls 

| +156 

1 

1 

1 

NA 

j NA 


L- 

_ _ 

1 

I 

_ 


-J 


Table 2. (Part 2 of 5) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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r 

Application Function 

| DOS/VS | 0S/VS1 | OS/VS2 
| (Times in milliseconds) 

i 

i 

r 

Storage 

Control 

1 

1 

I 

i 

i 

j 


"i 

i 

i 

i 


GETMAIN 

+ FREEMAIN (normal) 

| 0.3 

| 0.3 

| 0.3 

1 

i 


If one 

or more new pages are 

i 


1 

i 


needed. 

add: 

| +0.7 

| +0.9 

| +0.9 

i 


Primed 

storage 

| NA 

l 

| 0.07 

■ 

1 0.07 

I 

i 

i 


Journalinq 

1 

1 

| 

1 

1 

1 

1 

j 

1 

i 

i 


GETJCA 

(not requiring new page) 

| 0.17 

| 0.17 

| 0.17 

1 

i 


PUT 

STARTIO=YES - DISK 

| 2.4 

| 3.8 

| 4.0 

i 



- TAPE 

| 2.4 

| 3.6 

| 3.7 

i 



STARTI0=N0 3 - no I/O 

| 0.13 

| 0.13 

| 0.13 

i 



- DISK I/O 

| 3.3 

| 7.3 

| 7.8 

i 


WRITE 

STARTIO=YES - DISK 

I 1-9 

| 3.5 

| 3.7 

i 



- TAPE 

| 1.9 

| 3.4 

j 3.5 

i 



STARTI0=N0 3 - no I/O 

I 0.13 

I 0.13 

| 0.13 

i 



- I/O 

1 -USE STARTIO=YES 

values- 

i 


WAIT (block to be written) 

| 3.1 

| 4.7 

| 5.0 

i 


(none to be written) 

| 1.0 

| 1.0 

| 1.0 

i 


File Control 

1 

1 

1 

i 

i 

1 

I 

j 

i 

i 

i 


ISAM 

GET - INQUIRY 

| 10.5 

| 13.5 

| 16.0 

1 

i 



PUT - ADD 

| 

| 32.0 

| 32.5 

i 



GET - UPDATE 

| 10.5 

| 14.5 

1 16.0 

i 



PUT - UPDATE 

| 14.8 

| 21.1 

| 25.2 

i 



Cylinder index not 

i 

i 





in core, add 

1 

| +5.5 

| +5.8 

i 



CICS/VS logging (UPDATE), 

i 

i 

1 

i 



add: 

| +0.2 

| +0.2 

| +0.2 

i 



Logging forcing I/O, add 4 : 

| +3.3 

| +7.0 

| +7.5 

i 



Primed storage 

i 

i 

1 




GET (UPDATE) 

| NA 

| -0.4 

| -0.4 

i 



PUT/GET (INQUIRY) 

| NA 

1 

| -0.3 

I 

| -0.3 

j 

i 

j 


BDAM 

GET - INQUIRY 

| 3.0 

1 

| 3.7 

| 5.30 

i 



PUT - ADD 

1 4.3 

| 5.5 

J 8.8 

i 



GET - UPDATE 

| 5.5 

| 7.4 

| 10.6 

i 



PUT - UPDATE 

| 4.3 

| 4.9 

| 6.5 

i 



Logging (on update) 

| +0.8 

| +0.8 

| +0.8 

j 



Logging forcing I/O, add 4 : 

| +3.3 

| +7.0 

| +7.5 

i 



Primed storage 

1 

i 





UPDATE operations 

j NA 

| -0.3 

] -0.3 

i 



INQUIRY 

| NA 

i 

| -0.1 
| 

1 -0.1 

i 




1 


1 

-j 


Table 2. (Part 3 of 5) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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r 

Application Function 

| DOS/VS | OS/VS1 | OS/VS2 

1 (Times in milliseconds) 

*1 

r 

VSAM (DOS/VS VSAM s ) 


| 




KSDS GET - INQUIRY 

| 6.0 

| 4.8 

| 6.2 



PUT - ADD** 

| 10.1 

| 9.6 

| 10.5 



PUT - mass insert 

j 8.9+4.6N 

1 ~ 

j - 



of N records 






GET - UPDATE 

| 5.4 

1 5.0 

| 5.4 



PUT - UPDATE 

| 4.1 

| 4.1 

j 4.9 



DELETE 

| 11.0 

J 

| - 



Each index I/O, 

i 





add 6 : 

| +2.7 

| +2.5 

| +3.7 



Each index level 






other than first level 


1 




or sequence set, add 6 : 

| +1.0 

| +1.0 

| +1.0 



Control interval splits'* 1 17.0 

1 

1 



Primed storage 

1 





UPDATE 

| NA 

| -0.3 

| -0.3 



INQUIRY 

| NA 

| -0.2 
| 

| -0.2 



ESDS and RRDS 

i 

i 

1 




GET - INQUIRY 

| 4.9 

| 3.8 

| 4.8 



PUT - ADD 11 

| 9.0 

| 8.5 

| 9.7 



GET - UPDATE 

1 

| 4.2 

1 5.1 



PUT - UPDATE 

| 4.1 

1 4.1 

| 4.9 



BROWSE - N records 

| 10.0+ 






| 4.4N 

| - 

1 



Logging (KSDS, ESDS, 






RRDS) 

|(Use logging pathlengths for 




| BDAM, above) 

1 1 




VSAM ICIP (OS/VS2 only} 

i 

1 

[ 




KSDS GET 

| NA 

| NA 

1 3.5 



PUT 

| NA 

| NA 

j 3.. 0 



per index I/O 

| NA 

| NA 

| 2.0 



ESDS GET 

| NA 

| NA 

| 3.2 



PUT 

| NA 

| NA 

i 

| 3.0 



VSAM CHECK 

| 0.1 

1 

| 0.1 

| 0.1 



RELEASE 

| 0.2 

| 0.3 

| 0.3 



Temporary Storaqe 

1 

I 

1 




Main storage GETQ/GET 

| 0.25 

| 0.25 

| 0.25 



PUTQ/PUT 

I 0.40 

| 0.40 

| 0.40 



PURGE 

| 0.52 

J 

| 0.52 

| 0.52 



Auxiliary GETQ/GET (no I/O) 

| 0.15 

I 

| 0.30 

| 0.30 



storage® GETQ/GET (I/O) 

| 

| 3.5 

| 4.6 



PUTQ/PUT (no I/O) 

| 0.28 

| 0.4 

| 0.4 



PUTQ/PUT (I/O) 

1 

| 3.7 

j 4.8 



PURGE 

| 0.28 

| 0.28 

| 0.28 


L- 


1 



~ J 
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r 

Application Function 

| DOS/VS I OS/VS1 J OS/VS2 
j (Times in milliseconds) 


r 

Transient Data 

1 

1 

1 

] 

1 

1 



Intrapartition with VSAM 

I 

1 

1 

1 



GET 

| 3.0 

| - 

i * 



PUT 

■ 3.4 

1 - 

] - 



GET/PUT (no I/O) 

i 0.22 





with BDAM 

1 

1 

i 



GET first item 


| 6.7 

| 8.7 



GET subsequent 

i 3.2 

i 3 - 3 

| 4.3 



PUT first item 

| - 

| 25.8 

| 29.8 



PUT subsequent 

| 3.5 

j 11.4 

| 12.9 



PUT to a full track| 

| 22.0 
t 

| 25.0 



Extrapartition 

i 

1 

1 

! 

i 



GET (no I/O) 

| 

| - 

I — 



PUT (no I/O) 

| 0.33 

| 0.33 

1 0.33 



GET (I/O) 

1 

| 

j 



PUT (I/O) 

| 1.6 
i 

| 2.4 

a 

| 3.6 

i 



Table Search 

i 

i 

i 

1 

1 

i 

i 



i 

Sequential search (N=number of | 

I 

1 



entries searched before the 

i 

i 

i 



current entry is found) 

i 


i 



DFHDCT 

i 

i 

i 



intrapartition entries 

| 0.009 

| 0.009 

| 0.009 



extrapartition entries 

| 0.007 

| 0.007 

| 0.007 



DFHFCT 

| 0.004 

| 0.004 

| 0.004 



DFHPCT 

| 0.006 

| 0.006 

| 0.006 



DFHPPT 

| 0.006 
i 

| 0.006 

1 

| 0.006 
i 



Indexed search 

i 

i 

1 

1 

1 

i 



All tables 

i 

1 

i 



If number of entries is 

i 

1 

i 



between 2N-1 and 2N 

| 0.013N 

a 

| 0.013N 

1 

j 0.013N 
j 



Trace per call 

| 0.06 

| 0.06 

| 0.06 



or as a percentage of 

i 

1 




total pathlength 

| 15* 

1 

| 13* 

■ 

| 10% 
i 



Page Faults (that cause I/O) 

1 

1 

1 

1 

1 

1 

1 

1 

i 



Average values are: 

1 

| 1.5 

■ 

| 2.5 

1 

I 

| 3.6 



Miscellaneous 

1 

1 

1 

1 

1 

1 




Job accounting (DOS/VS only) 

| +7% 

1 

j NA 

I 

] NA 



MVS system resource manager - 

1 

i 

1 



approximately per address space per | 

i 




cycle: 

| NA 

| NA 

1 1.5 


L- 





-J 
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| Notes: 


1. A VPACING RESPONSE can usually be pro-rated across several WRITES; 
for example, if there is a pacing response sent on every third 
WRITE, 2.8/3 (0.93) must be added to each transaction. 

2. These READS and WRITES are additional to those included in ECHO 
paths. VTAM options will not always be the same as those used in 
the ECHO. 

3. If STARTIO=NO is used, and N is the average number of records in 
the block, 

(N-l/N) x (l/N) X STARTIO=YES 

should be used. The PUT plus STARTIO=NO times include the 
execution of timer SVC. 

4. A significant amount of processing is done at a sync point (often 
at the end of a task). A value of 4.0 milliseconds should be 
added, but this can be prorated across the number of updates 
between sync points. If I/O is forced because the buffer shift-up 
value is exceeded, the STARTIO=YES values should be used instead. 

5. If FASTTR=YES is specified, CICS/DOS/VS VSAM pathlengths may be 
reduced by up to 0.9 milliseconds per physical I/O. 

6. The VSAM KSDS times assume that each data set has a top-level index 
and a sequence set index. They also assume that no index I/Os take 
place (only the data I/O). Values are given to take account of 
index I/os and additional index levels. These values should be 
added, as appropriate, to the GET (INQUIRY and UPDATE), PUT (ADD), 
and DELETE values, but not to PUT (UPDATE). For example, if an 
OS/VS1 data set has 3 levels of index (two + sequence set) and only 
sufficient buffers allocated to keep the top level in core, the 
time for a GET (INQUIRY) would be: 

4.8 ♦ 1.0 + 2 x 2.5 
= 10.8 milliseconds 

The values for additional indexes may vary considerably depending 
on the number of records in the control interval and on the 
position of the index required in the control interval. Variations 
from 0.5 milliseconds to 2.0 milliseconds can be expected. 

7. The control interval split values are approximate. Considerable 

variation can be expected. %v 

8. I/O only occurs when the VSAM control interval becomes full (PUT), 
or when a new control interval is read in (GET). To obtain an 
average path with "N" records per control interval, 

(N-l/N) x no I/O timing ♦ (l/N) x I/O timing 

should be used. 

9. This percentage should be added to the BMS pathlength excluding 
terminal I/O. 

10. The 11.0 milliseconds addition makes an allowance for the loading 
of the RPG II program. For large programs (more than 12K bytes) 
this value may need to be increased. Sub-programs that are called 
will always be loaded and allowance should be made for these by 
using the program control program data. For medium-sized programs 
(between approximately 4K and 12K bytes) two loads should be 
allowed for. 
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11. PUT/ADD assumes that the control interval must be read in before 
data can be entered. This will not always be necessary if, for 
example, the control interval is in core from a previous operation. 


TABLE 3. 


r 

n ,n ■ .. . . 






***** * 

1 


ACCESS METHOD/ 

I DOS/VS 


| OS/VS1 

1 OS/VS2 



TERMINAL 

1 



1 

1 





1 B | 

c 

1 D 

| B I C 

| D | B | 

c 

1 D 1 


BTAM CCICS/VS 1.3) 

1 1 

1 1 


1 

1 

1 1 

1 1 1 

1 1 1 




BSC 3270 

Local 3270 

| 0 . 0610 
1 - 1 

.055 

|0.20 
1 - 

|0.06|0.03 

o 

VO 

O 1 

• 

o 

o 

CM 1 

• 

o 

.03 

10.20| 


Start-Stop 

| 0.06 | 0 

.04010.17 

|0.06|0.02 

| 0.1710.0610 

.02 

| 0.17 | 


Point to point 

10.351 

1 1 

0 

1 0 

|0.301 0 

i i 

| 0 10.30| 

i i i 

0 

1 0 1 


BTAM (CICS/VS 1.4) 

1 ! 

1 1 



1 1 

1 1 

i i i 

i i i 




BSC 3270 

|0 . 12| 

0 

|0.24 

| 0.12 | 0 

|0.24|0.12| 

0 

|0.241 


Local 3270 

1 ~ 1 

0 

1 

| - 1 0 

1 * 1 - 1 

0 

j - j 


Start-Stop 

| 0.12| 

0 

| 0 • 2 

| 0•121 0 

|0.20|0.12| 

0 

| 0.20 | 


Point to point 

10.35| 

0 

1 o 

J0.3 | 0 

i i 

| 0 10.3 I 

I f 1 

0 

1 o | 


VTAM 

1 1 


1 1 

1 1 

1 1 1 

1 1 1 




All devices 

1 o 1 

0 

1 0 

| 0 1 0 

1 0 1 0 1 

0 

1 o | 

L- 



— 




--- 



Table 3. Values for Line and Terminal Constants (B, C, and D) in 
milliseconds 

Notes; 


• Values for local 3270 networks are not currently available,. Remote 
3270 figures should be used as a first approximation. 

• In practice, the variation of CICS/VS pathlength with network size 
is a very complex function of network size and type, TP access 
method, transaction rate and CICS/VS functions used. The values 
given will only give an order of magnitude value. 

• For very high message rates (>5/second), the DOS/VS "C" values for 
CICS/VS 1.3 should be halved. For very low message rates 

(<0.5/second), the OS/VS "C" values for CICS/VS 1.3 should be 
doubled. In practice, in both cases the transition from one "C" 
value to the other will be a smooth function of the message rate. 

• The DOS/VS values for CICS/VS 1.3 assume that the ICVTSD value is 
set to zero. A higher value will decrease the pathlength. At one 
second it should be similar to the CICS/VS 1.3 values for OS/VS. 

• The CICS/VS 1.4 figures show significant improvements for large 
multipoint networks. The improvement shows where there are more 
than 3 terminals per line. 
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| TABLE 4 


r~ * - 1 

I System/370 Processor Relative Power | 

Model Factor | 


115 

50 

115*2 

85 

125 

85 

125-2 

120 

135 

185 

138 

230 

145 

350 

148 

430 

155-2 

600 

158 

860 

158-3 

950 

Hypothetical standard 
processor (see Note 3) 

1000 

3031 

1050 

168 

2100 

168-3 

2400 

3032 

2400 

3033 

4400 


l ---j 

Table 4. Approximate Relative Power Factors for Dedicated 
CICS/VS Systems 


Notes : 

1. The values for the 3031, 3032, and 3033 have not been measured in a 
dedicated CICS/VS environment and only represent a very rough 
estimate for guidance only. Possible errors are (plus or minus) 
10 %. 

2. The figures given do not account for the impact of the microcode 
assist feature that is available on some processors and will 
generally give a pessimistic result if the assist feature is used. 

A conservative estimate of the improvements is 10% in a dedicated 
CICS/VS environment. 

3. The hypothetical standard processors relative processing power is 

1000. 

TABLE 5. 


r""" 

1 


| DOS/VS | 

OS/VS1 

i 

OS/VS2 (MVS) 

i 

| CICS/VS 

1.3 



i 


i 

1 v 


i 0.2 

0.2 

i 

0.2 

i 

X 


| 1.0 

3.0 

i 

5.4 

i 

I Y 


| 0.04 

0.04 

i 

0.04 

i 

j z 

1 


| 0.07 

i 

0.07 

i 

0.07 

i 

1 

CICS/VS 

1.4 

i 

i 

! 

i 

i 


i 

v 


| 0.2 

| 0.2 

i 

0.2 

i 

1 x 


| 1.0 

3.0 

i 

5.4 

i 

1 Y 


| 0.05 

| 0.05 

i 

0.05 

i 

1 z 

i 


| 0.2 
f 

| 0.2 

i 

« 

0.2 

i 

i 

1 

L -r 


1 

1 

I 


1 

_ i 

Table 5. 

CICS/VS Background Timings 

(in milliseconds) 
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Chapter 8.3. Virtual Storage 


In order to run the system efficiently, the system programmer needs to 
be able to estimate the virtual storage requirements. If insufficient 
virtual storage is allocated, the system will either not function or it 
will suffer degraded performance. If the virtual storage requirements 
are grossly overestimated, performance will also suffer. Fortunately, 
the estimation does not need to be too accurate. In general, the system 
programmer needs to be able to calculate the virtual storage 
requirements to an accuracy of about 25% of the real storage size. For 
example, if a CICS/DOS/VS system with VSAM and VTAM were running on a 
370/145 with 512K bytes of real storage, the virtual storage allocated 
would probably be approximately 2.5 megabytes, and the system programmer 
should be able to gauge his virtual storage requirements to the nearest 
128K bytes. Calculation in greater detail is wasted effort. 

Virtual storage requirements are divided into four areas. These are: 

• Non-CICS/VS requirements, which include the operating system, major 
access methods, and work areas. These requirements exclude 
anything contained in the CICS/VS partition or region. 

• Static CICS/VS areas, that is, requirements for CICS/VS modules and 
tables storage which do not depend on the transaction rate. 

• Dynamic requirements of CICS/VS and major access methods which vary 
with the amount of traffic in the system. 

• Application programs and data area space. 

Figures 8.3-1, and 8.3-2 at the end of this chapter show the general 
disposition of storage for CICS/DOS/VS and CICS/OS/VS. Figure 8.3-3 
provides data that may be used to calculate the OSCOR size in 
CICS/OS/VS. 

These virtual storage areas are discussed in the sections which 
follow. 

In addition, the chapter also contains three tables of data: 

• Table 6 provides information on operating system requirements. 

• Table 7 gives the sizes of the CICS/VS modules and tables. 

• Table 8 gives the sizes of infrequently used CICS/VS modules. 


OPERATING SYSTEM AND MAJOR ACCESS METHOD REQUIREMENTS 


The appropriate manuals give detailed virtual storage estimates for the 
operating systems and major access methods. These estimates should be 
used when making detailed calculations, especially when other programs 
besides CICS/VS are being run on the same machine. 

The figures given below are for illustrative purposes only and 
represent only a small number of possible cases. Variations on these 
numbers will occur, depending on the options selected. 
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DQS/VS 


0S/VS1 


Minimum system + BTAM/ISAM/DAM 20OK bytes 
System with BTAM/VSAM 512K bytes 
System with VTAM/ISAM/DAM 1200K bytes 
System with VTAM/VSAM/ISAM 1600K bytes 


1•0M bytes 
1.5M bytes 
2.2M bytes 
3.0M bytes 


Table 6. Operating system requirements including major access methods 
but excluding CICS/VS 


STATIC CICS/VS AREA REQUIREMENTS 


The virtual storage requirements given below are for CICS/VS nucleus 
modules and control blocks, which are normally resident in virtual 
storage and are included in the CICS/VS partition or region. For 
CICS/DOS/VS, certain non-CICS/VS areas are included in the partition 
| because they are included in CICS/VS modules or tables. For OS/VS and 
| DOS/VS, CICS/VS gives part of its region's storage back to the operating 
I system. This is known as OSCOR (for OS/VS) and is discussed below. 

This section does not discuss areas which are allocated in the 
CICS/VS dynamic storage area. 


CICS/VS MODULES 


The storage requirements can be obtained by summing the sizes of all the 
CICS/VS modules to be used. An allowance should be made for the 
packaging of the various modules, and hence some module sizes should be 
rounded up to the next page boundary. A knowledge of the nucleus load 
table layout is required. Alternatively, the size of each module or 
table can be rounded up to the next page boundary. In addition to 
CICS/VS requirements, the sizes of all resident application programs, 
control blocks and maps should be added. 

Table 7 (below) gives the sizes of CICS/VS modules, with variations 
| for major options for both DOS/VS and OS/VS. 
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r 

1 

CICS/VS Module 

1 DOS/VS 

I 0S/VS 

r' 

1 

1 

DFHCSA 

including default 512 

1 

1 


1 


bytes user area 

| 4258 

1 

| 4258 

1 

1 

1 

DFHKCP 

(Task Control) 

| 7000 

t 

| 8192 

1 

1 

DFHSPP 

(Sync Point) 

1 

| 2720 

| 2900 

1 

1 

DFHSCP 

(Storage Control) 

1 

| 6400 

| 6200 

1 


Recovery=Yes 

| +3138 

| +2900 

1 

1 


Add size in bytes of the DSA in K bytes 

1 X t 

1 x 2 

1 

1 

DFHPCP 

(Program Control) 

1 

1 


1 


Assembler only 

| 3000 

| 3700 

1 


Assembler, PL/I, and RPG II (DOS/VS) 

| 4328 

| 4200 

1 


Assembler, COBOL, and RPG II (DOS/VS) 

| 5466 

| 6100 

1 

1 


All support 

| 5740 

1 

| 6400 

1 

1 

DFHTCP 

(Terminal Control non-VTAM) 

i 

i 


1 


BASE 

| 3200 

| 3600 

1 


Sequential support 

| +1000 

| +700 

1 


Console support 

| 

| N/A 

1 

1 


TCAM support 

| N/A 

■ 

| +3000 

1 

1 


Automatic initiation 

| +140 

| +160 

1 


BTAM support 

1 


1 


Start/Stop non switched 

1 0 

I 0 

1 


Plus Autopoll and Wraplist 

| +650 

| +270 

1 


Switched 

| +450 

j +430 

1 


Translate tables 2740/274lE/Sys/7 

| +520 

| +520 

1 


Correspondence 2741c 

| +290 

| +290 

1 


Text Mode Correspondence 2741CM 

| +260 

| +260 

1 


Text Mode EBCDIC 2741EM 

1 

| 


1 

1 


BTAM BSC - any device 

| +2080 

| +520 

1 


Non switched 

| +840 

| +800 

1 


Switched 

J +1300 

| +1200 

1 

1 


Translate table ASCII 

| +520 

1 

| +520 

I 

1 


1050 Translate Table 

| +520 

| +520 

1 


Switched support 

| +560 

| +480 

1 

1 


Non switched 

| +580 

1 

| +550 

1 


2260 Base 

| +720 

| +570 

1 


Local 

| +590 

| +590 

1 

l 


Remote 

| +920 

1 

| +850 

I 

1 


2740 Switched 

| +580 

| +510 

1 


Non switched 

| +590 

| +540 

1 

1 


Model 2 with Buffer Receive 

| +320 

I 

| +320 

1 

1 


2741 Switched 

| +500 

| +460 

1 


Non switched 

| +320 

| +300 

1 

f 


Other features 

| +360 

I 

| +460 

1 

1 


2770 Switched 

| +300 

| +300 

1 

L- 

-r « -r- M -j_ 

Non switched 

| +340 

| +340 

Table 7. 

(Part 1 of 4) CICS/VS Module Sizes in 

l Bytes 
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r 

1 

CICS/VS Module 

1 DOS/VS 

1 OS/VS 

r“ 

i 


2780 Switched 

| +300 

| +300 

i 

i 


Non switched 

| +360 

1 

| +360 

1 

1 

i 


2980 Common 

| +2400 

| +2400 

i 


Model 1 

| +330 

| +330 

i 


Model 2 

| +330 

1+330 

i 


Model 4 

| +350 

| +350 

i 

t 


TABLFIX=YES 

| +3850 

| +3850 

1 

i 

i 


3270 Support (BTAM) 

1 

| +1100 

| +900 

1 

i 


Local 

| +1730 

| +1730 

i 


Remote 

| +3300 

j +3300 

i 


Upper Case Translation EBCDIC 

| +320 

| +320 

i 

i 


Upper Case Translation ASCII 

| +280 

1 

| +280 

i 

i 


3270 Compatibility - Basic 

| +4000 

| +4000 

i 

i 


Additional features 

| +220 

i 

| +220 

1 

i 

1 

i 


3735 Dial 

i 

| +1430 

I 

1 

i 


3740 

| +350 

| +350 

i 


Switched 

| +1450 

| +1450 

i 

i 


Leased 

j +1200 

| +1200 

1 

1 

i 


3780 Switched 

| +300 

| +300 

i 

i 


Leased 

| +340 

| +340 

I 

i 


7770 



i 


CONVTAB = ABB 

| +330 

| +330 

i 

i 


CONVTAB = ABC 

| +280 

| 

| +280 

1 

i 

i 


System/7 

1 

| +200 

1 

j +200 

i 


Switched 

| +1000 

| +1000 

i 

i 


Non Switched 

| +860 

« 

| +860 

1 

i 


TLX 

| +1270 

| +1270 

i 

i 


TWX 

| +940 

1 

J +940 

1 

1 

i 

i 

DFHZCP 

(BTAM/VTAM Terminal Control) 

DFHZCP working set (BTAM only) 

| 1150 

| 1150 

i 


working set (3270 only) 

| 4384 

j 4384 

i 


working set (all support) 

| 5180 

| 5180 



DFHZCA working set (VTAM only) 

| 4256 

| 4256 

i 


DFHZCB working set (VTAM 3270) 

| 10900 

| 10900 

i 


working set (all support) 

| 13800 

| 13800 

i 


DFHZCX non-working set (BTAM only) 

| 916 

| 916 



non-working set (VTAM 3270 only) 

| 2280 

| 2280 

i 


non-working set (all support) 

| 5000 

| 5000 



DFHZCY non-working set (VTAM only) 

| 8264 

| 8264 

i 


DFHZCZ non-working set (VTAM 3270) 

| 4616 

| 4616 

i 

1 


non-working set (VTAM all) 

| 6424 

1 

| 6424 

i 

DFHICP 

(Interval Control) 

| 3212 

| 3212 

| 

1 

i 

L- 

DFHSDAM (DAM logic module) 

| 1900 

1 

j NA 

Table 7, 

(Part 2 of 4) CICS/VS Module Sizes in 

Bytes 
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r" 

1 

CICS/VS 

Module 


1 DOS/VS 

1 OS/VS 

i 

r 








DFHSRP 

(System Recovery) 


| 2044 

| 2400 



DFHFCP 

(File Control - DOS/VS only) 






VSAM 


| 5452 

| NA 




+ automatic 

journaling 

| 6980 

| NA 




ISAM+DAM 


| 5808 

j NA 




+ automatic 

journaling 

| 6876 

j NA 




DAM+VSAM 


| 7344 

j NA 




+ automatic 

journaling 

| 8872 

j NA 




VSAM+ISAM 


| 8156 

| NA 




+ automatic 

journaling 

| 9764 

j NA 




VSAM+ISAM+DAM 


| 9168 

| NA 




+ automatic 

journaling 

| 10816 

j NA 




ISAM 


| 3832 

| NA 




♦ automatic 

journaling 

| 4784 

| NA 




DAM 


| 4820 

| NA 




+ automatic 

journaling 

| 5764 

j NA 




Indirect access, input. 

and output 






segmenting, add 


| +1700 

| NA 



(OS/vs 

only) 






DFHFCP 

Common 


| NA 





VSAM Common 


| NA 





VSAM non-ICIP 


| NA 





VSAM ICIP 


| NA 

| +2048 




BDAM Support 


| NA 





ISAM Support 


| NA 





Automatic Journaling 


| NA 

| +840 




Maximum Size 


| NA 

| 11064 



DFHFCD 

(ISAM/BDAM only) 







Common 


| NA 

j 




BDAM 


| NA 

j 




ISAM 


| NA 

1 




Maximum Size 


| NA 

| 3656 



DFHTDP 

(Transient Data) 







Base + EXTRAPARTITION 


| 630 

| 504 




plus INTRAPARTITION 


| 3000 

| 3800 




plus Recovery 


| 5066 

| 5512 



DFHTSP 

(Temporary Storage) 







Base (AUX-NO) 


| 2702 

| 2672 




AUX=YES 


| 4928 

| 4200 




AUX=REC 


| 7178 

| 6312 



DFHTRP 

(Trace Control) 







AUX=YES 


| 8692 

| 6728 




AUX=NO 


| 2416 

I 1808 



DFHDCP 

(Dump Control) DISK (approx 

.) 

| 14000 

| 14000 




TAPE 


| 35932 

j — 


L- 

__ _ 





-j 


| Table 7. (Part 3 of 4) CICS/VS Module Sizes in Bytes 
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CICS/VS 

Module 

1 DOS/VS 

I OS/VS 


DFHJCP 

(Journal Control) 

| 3756 

1 

1 

DFHEIP 

(EXEC Interface Program) 

Base module DFHEIP 

Other modules (all support) 

1 

1 

| 4500 

| 6500 

1 

| 4500 

| 6500 

DFHDIP 

(Batch Data Interchange program) 

| 3344 

1 

1 

DFHISP 

(Intersystem Communication program) 

| 1034 

1 

1 

DFHMIR 

(ISC Mirror program) 

| 692 

1 

| 


Table 7. (Part 4 of 4) CICS/VS Module Sizes in bytes. 


BASIC MAPPING SUPPORT 

The following modules can be generated: 

DFHMCP Control Program 
DFHPBP Page Build 
DFHIIP Non 3270 
DFHTPP Terminal Page Program 
DFHM32 3270 Mapping 
DFHDSB Data Stream Builder 
DFHRLR Route list resolution 
DFHTPQ Terminal Page Clean up 
DFHTPR Terminal Page Retrieval 
DFHTPS Terminal Page Scheduling 
DFHFIP Faster 2260 
DFHF2P Faster 2260 
DFHBMSMM Pre-VS module 

Total virtual storage space requirements (assuming that the modules 
are resident and packed end-to-end) are given for a few different sets 
of BMS processing options. 


Minimum 3270 Mapping 

Minimum 3270 mapping + sequential devices 
Minimum 3600 mapping + sequential devices 
Default 3270 mapping 

Default 3270, 3600, 2740, 2770 mapping 

Default 3270, 3600, 2740, 2770 mapping + Paging and Routing 


6K bytes 
16K bytes 
14K bytes 
16K bytes 
23K bytes 
30K bytes 


These numbers will allow the user to gain an approximation to his 
actual sizes. This should be ample information to allow a calculation 
of sufficient accuracy to be made for the virtual storage requirements. 

The remaining CICS/VS programs are defined in the DFHPPT and can 
either be resident or non-resident in main storage. If they are 
resident, virtual storage should be allocated. If non-resident, space 
need not be allocated for all programs because they will not all be used 
concurrently. However, for reasons of efficiency, it is suggested that 
those programs used during on-line operation (that is, not at 
initialization or during shutdown) should be allocated space. The sizes 
given are maximums and are, for the most part, the same for DOS/VS and 
OS/VS. Where they differ, the larger is given. 
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PROGRAM NAME 

SIZE 

PROGRAM NAME 

SIZE 

DFHACP 

5230 

DFHNET 


DFHAKP 

692 

DFHPEP 

48 



DFHPLP 

152 

DFHAQP 

228 

DFHP3270 

1068 

DFHATP 

3476 

DFHRD1 

1906 

DFHBMSMM 

1896 

DFHRD2 

744 



DFHRKB 

116 

DFHRUP 

7485 

DFHSFP 

248 

DFHCPY 

292 

DFHSNP 

2352 

DFHDBP (for DL/I) 

7890 

DFHSTKC 

5416 



DFHSTLK 

2212 

DFHEXI 

172 

DFHSTP 

3954 

DFHPRK 

440 

DFHSTPD 

1792 

DFHRKB 

116 

DFHSTSP 

5728 

DFHCWTO 

1656 

DFHSTTD 

3164 

DFHFEP 

4420 

DFHSTTR 

5104 

DFHJCBSP 

408 

DFHTACP 

5140 

DFHJCC 

308 

DFHTAJP 

696 

DFHJCEOV 

460 

DFHTBP 

10794 

DFHJCI 

1048 

DFHTDRP 

1316 

DFHJCIOE 

612 

DFHTEP 

40 

DFHJCKOJ 

660 

DFHTEPT 

— 

DFHJCO 

2700 

DFHTPQ 

2484 

DFHJCSDJ 

464 

DFHTPR 

11496 

DFHMSP 

10908 

DFHTPS 

608 

DFHMTPA 

8900 

DFHTSRP 

3280 

DFHMTPB 

8740 

DFHUAKP 

— 

DFHMTPC 

9684 

DFHWTl 

2822 

DFHMTPD 

5756 

DFHWT2 

1764 

DFHMTPE 

6412 

DFHZNAC 

10408 

DFHMTPF 

8764 

DFHZNEP 

56 

DFHMTPG 

8532 

DFHZRLG 

360 

DFHOCP 

3388 

DFHZRSP 

556 


Table 8. Sizes of Infrequently Used CICS/VS Modules 


CICS/VS TABLE SIZES 


The sizes of CICS/VS tables and static control blocks depend on the 
number of entries in the various tables. The virtual storage 
requirements should include space for all entries, together with an 
allowance for expansion as more devices, data sets or programs are added 
to the system. Tables which are used during system initialization and 
then overwritten are not included in these estimates. 

The sizes of the various tables given below should be rounded up as 
necessary to the next page size unless the tables are packed close to 
other modules or tables. The nucleus load table in use (default or 
user-supplied) should be used to assist in the mapping of these tables. 
In all the tables below, "E" is the number of entries, "C" is the table 
header or constant value, and "R" is the number of remote entries (for 
use with connected systems). 


PROGRAM CONTROL (DFHPCT) 

| Size=C + 64E + 32R 

For the sequential scan routine, C=160 bytes, and for the index scan 
| C=176 bytes. In addition, when the INDEX option is used, on additional 
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| 106 bytes per identifier should be allowed for the index table.. E 

should include the CICS/VS service programs, a list of which is given in 
| Appendix A under "Program Control Table". 


PROCESSING PROGRAM TABLE CDFHPPT) 

Size=C + 40E + 52CE for OS/VS 

Size=C + 56E + 68CE for DOS/VS 

where: "C" is 160 bytes. If PAGENXD=YES is used, "C"=176 bytes and an 
additional 10 bytes per entry is required for the index table. 

"E" is the number of assembler, PL/I, and RPG II entries. "CE" is the 
number of COBOL entries. 

DESTINATION CONTROL (DFHDCT) 

Size=140 + (El + E2 + ...E n ) ♦ AM 

where "E n " are the sizes of each entry (see the table below) and "AM" is 
the total number of bytes required for access methods when using 
CICS/DOS/VS. The sizes of the DOS/VS access method modules can be found 
in the DOS/VS System Generation manual for the appropriate release. If 
PAGENXD= YES is used, add 6 bytes for each INTRA or EXTRA entry. 


Entry Sizes 

TYPE=INTRA 84 bytes 

TYPE=EXTRA 16 bytes 

TYPE=INDIRECT add 16 bytes 

TYPE=REMOTE add 24 bytes 

To the above, add the following as appropriate for TYPE=SDSCI (1 per 
physical data set): 



DOS/VS 

OS/VS 

Automatic OPEN, BUFNP=n 

nxB 

Note 1 

Printer 

60 

96 

Disk - Fixed input 

140 

96 

- Fixed output 

172 

96 

- Variable output 

180 

96 

Tape - Standard labels 

16 

96 

- Fixed records 

100 

96 

- Variable records 

112 

96 


Note 1 : B=buffer length for DOS/VS. For OS/VS, although the storage is 
not part of the table, it must be given back to OS/VS as part of OSCOR. 

TEMPORARY STORAGE (DFHTSUT) 

a) DFHTSUT Size =32+32E 

b) Temporary storage data set control information size = 272 + M bytes 
where M= the number of control intervals in the temporary storage 
data set. 

c) Two buffers (each to accommodate the VSAM control interval size). 
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TRACE CONTROL (DFHTRT) 


Size=58+16E 

SYSTEM RECOVERY (DFHSRT) 

Size=1300+16E 


TERMINAL CONTROL 

(DFHTCT) 



PREFIX 


740 

bytes 



DOS/VS 

OS/VS 

TYPE= SDSCI 

Card Reader/Printer/Tape 

54 

36 


Disk 

152 

152 


27 41C/2741E 

152 

36 

TYPE=LINE 

(not VTAM) 

88 

88 


POOLADR= 

+ 4 

+ 4 


Device=BSC device 

+ 40 

+ 40 

TYPE=TERMINAL 

Start/Stop 

164 

164 


BSC including 3270 

180 

180 


VTAM terminals 

296 

296 


VTAM 3270 

316 

316 

VTAM Support 

Exit routines, ACB etc 

4000 

4000 

DTFs/DCBs 


184 

96 

Sequential disk logic 

1000 

NA 

RAPOOL 

Each VTAM fixed RPL 

112 

112 

Each VTAM NIB 

(1 per logical unit) 

64 

64 


BTMOD for DOS/VS only 

(see the DOS/VS System Generation manual) 


FILE CONTROL (DFHFCT) 

DOS/VS Size=100 + 160V + 280B + 7001 + ISMOD + EXCPAD + II 

OS/VS Size=100 + 172V + 140B + 2881 + II 

where "V", "B" and "I" are the number of VSAM, BDAM and ISAM files; "II" 
is the ISAM resident index area size; "EXCPAD" is the VSAM exit routine 
size (=180 bytes) and "ISMOD" is the ISAM logic module. See the DOS/VS 

System Generation manual for the exact size. 5K bytes may be taken as an 

approximate value. 

JOURNAL CONTROL (DFHJCT) 

OS/VS Size=50+268E 

DOS/VS Size=164E + 16 + 152SD + 48MT + SDMOD ♦ MTMOD 

where SD = number of DTFSD* s and MT = number of DFTMT*s. See the DOS/VS 

System Generation manual for the sizes of SDMOD and MTMOD. 
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SIGN-ON (DFHSNT) 


Size=36E 

PROGRAM LIST CDFHPLT) 

Size=8E 

TRANSACTION LIST (DFHXLT) 

Size=4E 


CICS/VS DYNAMIC STORAGE AREA 


The object of this stage is to decide how much virtual storage is 
required for the dynamic storage area so that, under normal operating 
conditions, the short-on-storage condition will only appear in error 
situations (for example, when application programs do not free storage). 
Obviously, this can be done by allocating excessive amounts of virtual 
storage to the partition or region. It is, however, preferable to 
estimate the requirements and use this as a starting point for tuning 
the system. 

The requirements may be divided into the following sections: 

• Storage for non-resident CICS/VS and application programs and maps 

• Working storage used during the execution of application programs 

• Storage cushion 

• Temporary storage 

• VSAM buffer storage. 

| • OSCOR (OS/VS only) or the DOS/VS GETVIS area 

| These items are discussed below. 


PROGRAM STORAGE 


Under normal circumstances most of the programs and maps in common use 
will be resident in main storage. Space must be allowed in the DSA for 
the maximum number of the remaining programs and maps which are likely 
to be resident in main storage at any one time. The size of each 
program should be rounded up to the next page size (2K or 4K bytes) when 
making this calculation. 


WORKING STORAGE 


The average virtual storage per transaction is calculated. This should 
be multiplied by the maximum number of transactions which can exist 
concurrently (MXT) to give the total working storage. 
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CICS/VS allocates storage into a number of subpools to separate 
different types of usage in a logical manner. There are eight subpools 
(including the program storage subpool described above). Most programs 
will normally use either three or four subpools, depending on whether 
BTAM or VTAM is the access method being used. To avoid unnecessarily 
detailed calculations, 6K bytes (8K bytes if VTAM) should be allowed for 
each task as a basic requirement. In addition, any requirement for 
large FIOAs (file input/output areas), LIOAs (BTAM line input/output 
areas) and TIOAs (terminal input/output areas) should be added. These 
should be estimated on the basis of the lengths of data (records or 
messages) input to or output from the program. In addition, an 
allowance should be made for any application program use of CICS/VS 
storage management GETMAIN requests. 

It should be emphasized that while this approach is approximate, it 
should be adequate for virtual storage calculations. 


STORAGE CUSHION 


This area of storage is only used by CICS/VS if it runs out of virtual 
storage. If this area is used then, under normal circumstances, either 
"errors" have occurred or the virtual storage allocation for the CICS/VS 
partition or region was too small. 

The size of the storage cushion should be about four pages larger 
than the largest non-resident program or map. 


TEMPORARY STORAGE 


CICS/VS temporary storage uses either VSAM or main storage to store the 
user's data. If VSAM is used, space equivalent to two VSAM control 
intervals should be allowed. If main storage is used, the product of 
the maximum number of entries and the average entry size should be used. 


VSAM BUFFER STORAGE 


Although VSAM buffers are not strictly part of the dynamic storage area 
(unlike ISAM and BDAM FIOAs) it is convenient to discuss their 
| requirements at this stage. In DOS/VS, the GETVIS area is used, while 
| for OS/VS, OSCOR is used (see below). 

For each file allow 10K bytes for VSAM control blocks. If the index 
control interval size is ICI and the data control interval size is DCI, 
the minimum virtual storage required per file is: 

DCI (1+STRNO) + ICI x STRNO 

rounded to the next page size. This size will be increased if extra 
buffers are allocated. 

If VSAM shared resources are used, the total will depend on the total 
number of control intervals requested multiplied by the control interval 
size. 
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| OSCOR DEFINITION 


The address space referenced as OSCOR is that storage available to the 
OS/VS operating system to perform partition-related services in response 
to an operating macro or SVC issued by the partition. The operating 
system will use this area to build control blocks or for use as work 
areas. 

The CICS/VS system initialization program (SIP) will ensure that the 
amount of storage specified in the OSCOR parameter is returned to the 
operating system. 

The reason this parameter is necessary in a CICS/VS system is that 
CICS/VS will acquire and manage all remaining storage in the partition 
that remains after the CICS/VS nucleus* tables* and resident programs 
have been loaded. 

Because of the dynamic nature of a CICS/VS system, the demands on 
OSCOR will vary during the day, that is, as the number of tasks 
increases or data sets are opened and closed. Also, because of this 
dynamic use of OSCOR, fragmentation will occur so that additional 
storage must be allocated. 

During initialization CICS/VS will only open data sets that the user 
requests. The control blocks that are built at open time are allocated 
within the CICS/VS partition and do not place a requirement on OSCOR. 

The OSCOR requirements for these data sets are control blocks built for 
the duration of the I/O event and any buffers required. 

If a data set is opened after CICS/VS initialization, the control 
blocks built at open time will be allocated from OSCOR. 

It is assumed that access methods are resident in the OS/VS 
supervisor and will not be loaded into OSCOR. 

Figure 8.3-3 (below) gives values applicable to 0S/VS1. Values for 
OS/VS2 may be taken as approximately the same. It is recommended that 
the total calculated for a region is increased by about 25 % to make 
allowance for fragmentation. 


APPLICATION PROGRAMS 


The user should know the sizes of all application programs and data 
areas. An allowance should be made for all programs that can possibly 
reside concurrently in main storage, irrespective of whether they are 
| marked in the PPT as resident or non-resident. In the case of RPG II 
| programs, an allowance should be made for several copies, because the 
j RPG II object code is not reentrant. 
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PARTITION SAVE AREA AND LABEL AREA 
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CICS/VS 
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Figure 8,3-1. 
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OS/VS Free/Allocated Storage 


PAM 

-1 


Dynamic 

Storage 

Area 
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Figure 8.3-2. Storage Organization for CICS/OS/VS 
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1 » 


r—-- 

I Function 


BTAM 

per local line group 
per local line 
per remote line 

VTAM 

per concurrent OPNDST 
and CLSDST 

BSAM 

per data set 

QSAM Extrapartition transient data 
per data set 
per buffer 

ISAM 

per data set 

per outstanding I/O request 

VSAM 

per data set 

per data set (approx.) 

per data set (ESDS or KSDS) 

per KSDS data set 

BISAM 

per data set (approx.) 
per buffer 

BDAM 

per data set (approx.) 


OSCOR Size in bytes 


300 

140 

184 


1000 


220 


200 

16+blksize 

index size 
100+blksize 
100 


4000 

500 x STRNO 

BUFND x data CISIZE 

BUFNI x index CISIZE 


1000 

Blksize+16 


400 


j 


Figure 8.3-3. Calculating the OSCOR Size 
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Chapter 8.4. Real or Reference Set Storage 

Requirements 


It is essential to be able to estimate the amount of real storage 
required by a CICS/VS system. Excessive paging (caused by a heavy over¬ 
committment of real storage) is a common cause of performance problems. 
It is recommended that, under normal, steady state, error-free 
conditions, a system should execute without page-faults in order to 
minimize response times and to maximize throughput. The amount of 
storage required is usually referred to as the working set or the 
reference set . 

In a normal system, error and exception conditions, together with 
fluctuations in the workload, will occur, which may cause page-faults. 
However, provided this only occurs for short periods, the overall 
efficiency of the system will not be significantly affected. 

The reference set is discussed in terms of: 

• Operating system requirements 

• The major access methods and other components used by CICS/VS 

• CICS/VS 

The discussions of the first two items are brief because more 
detailed information can be found in the appropriate operating system 
and access method publications. 

The chapter contains three tables, which provide information on VTAM 
and VSAM reference set sizes, and Figures 8.4-1 and 8.4-2, which give 
reference set sizes for CICS/DOS/VS and CICS/OS/VS. 


THE OPERATING SYSTEMS - DOS/VS. OS/VSl. AND 0S/VS2 (MVS) 


Detailed storage calculations for DOS/VS and the various access methods 
used can be found in the DOS/VS System Generation manual. All the 
storage used by the DOS/VS supervisor is fixed, and is therefore part of 
the reference set. Examples are given below for a number of 
representative systems. Variations on these numbers will occur, 

| depending on the options specified. Variations will also occur 
| depending on the release of DOS/VS used. Values quoted for DOS/VS 
| assume Release 34. 

370/115 or 125 with BTAM support, AP=NO, 2 partitions 
| Size =48K bytes 

370/135 with VTAM, ISAM/BDAM support, FASTTR=NO, 3 partitions 
| Size =60K bytes 


| 370/138 with BTAM, VSAM support, FASTTR=YES, 3 partitions 
I Size =58K bytes 


| 370/148 with VTAM, VSAM, ISAM, BDAM support, FASTTR=YES, 5 partitions 
I Size =7OK bytes 


In addition to these sizes, an additional page is fixed in the 
CICS/VS partition for use by DOS/VS. 


Chapter 8.4. Real or Reference Set Storage Requirements 


585 




Users of 0S/VS1 should consult the 0S/VS1 Storage Estimates manual. 
Typical systems will usually have requirements of between 14OK bytes and 
200K bytes. 

Users of 0S/VS2 should consult the 0S/VS2 System Programming Library 
Storage Estimates manual. 


THE MAJOR ACCESS METHODS AND COMPONENTS USED BY CICS/VS 

The reference sets of the major access methods listed below are 
discussed: 

• VTAM 

• BTAM 

• VSAM 

• ISAM 

• BDAM 

• DL/I 

Detailed information can be found in the appropriate access method 
manuals. The data presented here is only intended to give an overall 
picture. 

VTAM REFERENCE SET 


VTAM reference set requirements can be split into four areas. These 
are: 


• Fixed VTAM code 

• Pageable VTAM code 

• VTAM control blocks - dependent on the network size 

• VTAM buffers - dependent on message lengths and transaction rates. 

The actual values given will vary slightly from one VTAM release to 
another and also depending on the different mixes of terminal types. 
There will also be slight variations depending on the CICS/VS and VTAM 
options used. It is estimated that the figures given below will cover 
most circumstances to within 10%. 

Note : These sizes do not include any allowance for OPNDST, CLSDST, 

VARY, TRACE, NETSOL or similar VTAM commands. 
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DOS/VS 


QS/VSl 


OS/VS2 (MVS) 


3270 BSC 


Fixed Code 

Pageable Code 

18 

54 

28 

68 

36 

104 

Total Code 

72 

96 

140 

3270 Local 

Fixed Code 

26 

28 

44 

Pageable Code 

54 

66 

84 

Total Code 

80 

94 

128 

SNA Devices 

Fixed Code 

18 

28 

36 

Pageable Code 

46 

54 

68 

Total Code 

64 

82 

104 

3790 LCA 

Fixed Code 

18 

32 

40 

Pageable Code 

42 

50 

60 

Total Code 

60 

82 

100 


Table 9. VTAM 2 Reference Set Sizes in K bytes 

Note : Where combinations of the above devices are used in the same 
network, these sizes will be increased. These sizes refer to VTAM2. If 
VTAM3 is used, some savings can be achieved. Where VTAM is added to an 
existing system, some increases in operating system reference set size 
will occur. These depend to some extent on the contents of the existing 
system. Probable increases are: 

• DOS/VS - 4K bytes 

• OS/VS1 - 26K bytes in the PQA. 

• OS/VS2 - 24K bytes in the LSQA 


VTAM Control Blocks Excluding Buffers 


VTAM control blocks are allocated in different storage pools. The 
numbers given are per terminal, logical unit or control unit. When 
these numbers are multiplied by the number of terminals, the result for 
each pool should be rounded up to the next page size (2K bytes for 
DOS/VS and OS/VS1, 4K bytes for 0S/VS2). 
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| Table 10. VTAM2 Reference Set Storage in bytes 

Note : For Local 3270 only, there is an additional 416 bytes per 

terminal in the FPQA (fixed) for OS/VSl and 584 bytes per terminal in 
the LSQA (fixed) for 0S/VS2. 

| For VTAM3, some significant reductions in the control block sizes 
| have been achieved. 


| BTAM REFERENCE SET 


BTAM fixes the area containing its code while there is any outstanding 
terminal I/O. Under normal circumstances* where the time spent by the 
terminal operator thinking and keying in data far exceeds the processor 
processing time, this is equivalent to saying that BTAM code is 
permanently fixed. 

In addition, the line I/O areas (into which BTAM reads data and 
transmits data from) and other control blocks are permanently fixed. 
These areas include the DECB and DTFBT for DOS/VS, and the DECB and DCB 
for OS/VS. 
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Sizes of BTAM code are given in SRL manuals for each operating 
system. Typical values (in bytes) are: 


Local 3270 

DOS/VS 7,200 

OS/VS1 5,600 


Start/Stop 

only 

9,400 

9,600 


BSC only 

10,000 

10,200 


Start/Stop 
+ BSC 

17,000 

10,600 


I Note : For DOS/VS systems, the BTAM code (BTMOD) is contained in the 
| CICS/VS terminal control table (DFHTCT). 


VSAM REFERENCE SET 


Code and control block storage associated with VSAM will depend on the 
features being used, the number of data sets, and the product of the 
transaction rate and the length of time the data is in use. For 
example, an update operation that spans a terminal I/O will need more 
storage than update operations where the PUT immediately follows the 
GET. 

Typical figures and formulae for normal processing are given below. 
Rare cases such as control interval splits will require additional 
storage. Detailed information can be found in either VSAM or operating 
system manuals such as DOS/VS System Generation . OS/VS1 Storage 
Estimates, and OS/VS2 Storage Estimates . 


VSAM 

|DOS/VS 

j OS/VS 

Basic Code 

| 22K 

| 40K 

Extension Code 
including Cl splits 

1 

1 

| 4K 

1 

1 

1 

Shared resources 

I 2K 

i 

1 

1 

Per data set 

| 6K 

| 6K 


j Table 11. VSAM Reference Set Sizes in K bytes 

I 

| In addition, storage space is required for buffers that are used to 
| hold index records and data records. The parameters used in this 
I calculation are: 

| • CISIZE - Control interval size (separate values for data and index) 

| • BUFNI - Number of index buffers 

| • BUFND - Number of data buffers 

| • STRNO - Number of VSAM strings 

I 

| A discussion on the choice of values to be specified can be found in 
j the performance section in the appropriate CICS/VS System Programmer's 
I Guide . 

| The size for each data set is given by: 
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Size= Data CISIZE x BUFND + Index CISIZE x BUFNI 

If BUFND and BUFNI are not specified, the following formula should be 
used: 

Size= Data CISIZE x (STRN0+1) + Index CISIZE x STRNO 

If the data set is ESDS, the index CISIZE is zero. 

In DOS/VS, VSAM code is usually in the SVA, and the buffers and 
control blocks are in the GETVIS area associated with the CICS/VS 
partition. In OS/VS, the VSAM code is part of the pageable supervisor, 
and the buffers and control blocks are in space allocated to OSCOR. 

In general, if all the opened data sets are in frequent use, all the 
buffer storage can be considered to be part of the reference set. 


ISAM REFERENCE SET 


In DOS/VS, the ISAM logic module and control blocks are part of the 
CICS/VS file control table and are discussed in the section on CICS/VS 
tables. For OS/VS, the code is loaded into the CICS/VS partition during 
initialization, and the control blocks are part of OSCOR. 

Reference set sizes for OS/VS are approximately: 

• Code - 3OK bytes (measured for inquiry and update operations) 

• Control blocks per data set - 100 bytes x (1 plus the number of 
outstanding I/O requests), plus buffers for blocksize and cylinder 
index. 


BDAM REFERENCE SET 


For DOS/VS, the BDAM logic module is a CICS/VS module; the control 
blocks are in the CICS/VS file control table, which is discussed later. 
For OS/VS, code is loaded in the CICS/VS partition, and the control 
blocks and buffers are included in OSCOR. 

BDAM code size for OS/VS is approximately 8K bytes, and approximately 
another 28K bytes is referenced, giving a total of 36K bytes. 


DL/I REFERENCE SET 


Detailed information on DL/I reference set size can be found in the 
DOS/VS DL/I System/Application Design Guide manual and in the IMS/VS 
System Programming Reference Manual . Sizes will depend on the options 
selected, the operations used, and on the structure of the data bases. 
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| CICS/VS REFERENCE SET 


| The CICS/VS reference set for a particular transaction or operation is 
defined as the amount of real storage required to process the 
| transaction without causing any page I/O. This storage does not include 
j storage external to the CICS/VS partition or region, or storage in the 
j DOS/VS GETVIS area, or the OS/VS OSCOR area. These requirements are 
j dicussed above. 

If several transactions of the same type are being processed 
| simultaneously, more real storage will be needed. The reference set can 
be divided into a static part and a dynamic part. The former is 
independent of the transaction rate, whereas the latter is directly 
proportional to the number of transactions being processed concurrently. 

| Hence, the reference set for a particular transaction where T 

transactions are being processed simultaneously can be represented by 
the equation: 

| Reference set = SRS + T x DRS 

where "SRS" and "DRS" are the static and dynamic components of the 
| reference set of a single transaction. 

In most CICS/VS systems several different types of transactions may 
| be processed concurrently and estimation of the total reference set 
becomes more complicated. 

Each transaction being processed concurrently, whether of the same or 
J different types, will have its own dynamic reference set. The total 
| dynamic reference set is the sum of all the individual reference sets. 

| To determine the dynamic reference set it is necessary to calculate 
| the average number of transactions that are executing simultaneously. 

| For conversational transactions , this should be taken as the number 
j of transactions that are active, that is, the number of terminals signed 
| on to a particular transaction. 

I For non-conversational transactions , "T" can be calculated as 
j follows. 

| If "R" is the transaction rate of a particular transaction and "C" is 
j the host processor (or CICS/VS) response time in seconds, the average 
j number of simultaneous transactions is "CR". However, it is necessary 
j to make some allowance for the distribution of the transactions. To 
j maintain a 10:1 chance (approximately) of not exceeding the T 

| requirements, a value of DRS equal to 3 x CR should be used for that 

j transaction. The value obtained should then be rounded up to the next 
j whole number before multiplying it by the DRS value for that 
j transaction. Values should be obtained for all the frequently used 
| transactions and then summed. 

| The total static reference set can be estimated as follows. Each 
transaction type is made up of a BASE (or ECHO) transaction with 
additional functions (for example, file control GETs or transient data 
| PUTs). Each such function has a fairly well-defined static reference 

| set. The total static reference set is the sum of the base reference 

| set and all the static reference sets for the different functions which 
will be processed concurrently. Some allowance is also necessary for 
the size of CICS/VS tables which will depend on such things as the 
| network size and the number of files and application programs. In 
j addition, the reference sets of the application programs must be taken 
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| into account. Data for CICS/VS reference set calculations is given in 
I Figures 8.4-1 and 8.4-2, below. 

It should be noted that it is not necessary to include all possible 
transaction types. The least frequently processed ones can be excluded. 
| As a guide, those transactions which are executed less than once per "S" 
j seconds should be excluded (where "S" is the larger of 100 or 

100/(transaction rate) where the the transaction rate is measured per 
second). 

An alternative method is to order the transactions (or programs) by 
frequency of use. Starting with the least frequently used transaction, 
divide the number of times it is executed by the total number of 
transaction executions,. The values obtained for each transaction should 
| be summed in order of ascending size starting with the lowest. When the 
sum has reached 0.05, all the transactions summed should be excluded 
| from the reference set. The number of transaction executions can be 
obtained from CICS/VS statistics output. 

The tables below give the following data: 

| • The base and function static reference sets 

| • Base and function minimum dynamic reference sets 

The data in these tables is intended to be used only as a guide. 
Allowance must be made for application programs, maps and data areas. 

| The reference set will depend to a certain extent on where the 
various programs and maps are loaded into virtual storage. The sizes 
given are generally based on default loading. This can be improved (or 
degraded) by using the nucleus load table. 

| Examples of the use of this technique of calculating reference sets 
| are given in Chapter 8.7. 


| CICS/VS REFERENCE SET TABLES 


| The two following tables (Figures 8.4-1 and 8.4-2) give static and 
] dynamic reference set sizes for DOS/VS and OS/VS systems. The sizes 
j given under the "CICS/VS" heading include all CICS/VS components in the 
j CICS/VS partition. They do not include areas in the DOS/VS GETVIS area 
j or in the OS/VS area, even though they are in the CICS/VS partition. 

| The column headed "OTHER" includes areas not included under the heading 
j "CICS/VS" and may be in the CICS/VS partition or in the SVA or the LPA. 

| Data for the following items is not given: 

1 • Supervisor code and control blocks 

| • Application code, maps, and data areas 

| The column headed "OTHER" includes components that may be used by 
| several CICS/VS functions. When summing the various "STATIC" sizes, the 
j same components (for example, VSAM) should not be added more than once. 

| The data is approximate. It represents a medium system; actual 
| installations may find that sizes vary depending on the exact options 
j selected. 
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Notes: 


1. Minimum table sizes or optimum ordering of entries is assumed. 

2. CICS/VS user data areas are the larger of 256 bytes or minimum 
values. These include TIOAs and FIOAs. These minimum values are 
allowed for in the BASE sizes. 

3. Where values are not tabulated, it is recommended that virtual 
storage sizes are substituted for all frequently used functions. 
Infrequently used functions (for example, master terminal support 
for CSMT) should be ignored. 

4. It is assumed that CICS/VS modules only contain those functions 
that are frequently used. Hence, if the actual system contains 
functions that are used infrequently (for example. Terminal Control 
with sequential disk support) the sizes of these functions obtained 
from the virtual storage tables in Chapter 8.3 should be added to 
the reference set size. 
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Function 


r nr 

Static Reference Set J | Dynamic Reference Set 


CICS/OS/VS 


Base functions 


CICS/VS 


BTAM 3270 BSC 
BTAM start/stop 
BTAM 3270 local 

VTAM 3270 local/BSC 
VTAM SNA 


Additional functions 
(to be added to 
BASE values) 


82 

76 

74 


BMS 

- minimum 3270 

- average 3270 

- PAGING/ROUTING 

Command level 
interface 

File control 

- VSAM 

- BDAM/ISAM 

- VSAM/ISAM/ 

BDAM - per 

active file 

- VSAM 

- ISAM 

- BDAM 

Journal control 

Macro level 
interface 

Temporary storage 

Terminal control 

- BTAM per line 

- BTAM per device 

- VTAM per LU 


Transient data 


0-12 

0-20 

0.35 


OTHER 


See 

Tables 

9610 


0.19 

0 

See 

Tables 

9610 


TOTAL 


0.31 

0.20 


CICS/VS 


0 

0 

0 


OTHER 


0 

0 


TOTAL 


0 

0 

0 


Figure 8.4-2. CICS/OS/VS Reference Set Sizes in Bytes 


Note : The "OTHER" column refers to OS/VS1, but will be approximately 

true for OS/VS2. 


Chapter 8.4. Real or Reference Set Storage Requirements 


595 















Chapter 8.5. Physical I/Os 


One of the important resources in a system is the disk I/O subsystem, 
which includes channels, control units and disk devices. To ensure that 
bottlenecks do not occur and that the reponse of the subsystem is as low 
as possible, it is essential to spread the load out evenly across the 
various devices. To do this, the system programmer must be aware of the 
load on the various disks. This can be related back to CICS/VS 
transactions if the number of physical I/Os (as distinct from logical 
I/Os) initiated by each CICS/VS function is known. 

Figures 8.5-1, 8.5-2, and 8.5-3 provide information on physical I/Os 
in relation to CICS/VS functions, and on the capabilities of disk 
devices. 

This chapter provides data that relates the number of physical I/Os 
to CICS/VS functions. For example, when a file control GET is issued to 
a VSAM KSDS file with three levels of index with the minimum buffer 
allocations, four physical I/Os will take place; three for index records 
and one for data. If the GET had been issued to a VSAM ESDS file, only 
one I/O would have taken place. If the two files had, for example, been 
placed on separate disks and if an equal number of logical I/Os had 
occurred for each file, there would be a 4:1 imbalance, probably 
resulting in poorer performance than necessary. 

Figure 8.5-1 gives average numbers of physical I/Os caused by CICS/VS 
functions. In some exceptional cases, there will be variations to these 
values. In general, these values apply to both DOS/VS and OS/VS 
systems. 
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CICS/VS functions 


Average number of 
physical I/Os 


File Control 


BDAM PUT/GET 

GET (UPDATE) 

PUT (UPDATE) 

VSAM ESDS GET/PUT 

GET/PUT (UPDATE) 

KSDS with minimum buffer allocation 
If N is the number of index levels 
including the sequence set, then; 
GET 
PUT 

GET (UPDATE) 

If one additional buffer allocated, 
1+N can be reduced to N. 

If more than one additional buffer, 
number is between N and N-l 

ISAM (cylinder index in core) 

GET 

PUT 

GET (UPDATE) 

PUT (UPDATE) 

If cylinder index not in core, 
add 1 to the above values. 

Overflow records (GET), 
where F is the position of the 
record from the start of the 
chain. 

Temporary Storage (auxiliary) 


1 

2 

1 

1 

1 


1+N 

1+N 

1+N 


1 

1 

1 

2 


1+F 


GET/PUT/GETQ 

PUTQ 


1 

1 


Transient Data 


Intrapartition BDAM; 


PUT to queue 

PUT to empty queue 

PUT to queue that fills the track 

GET first record from queue 

GET subsequent record from queue 


1 DOS/VS 

1 OS/VS 1 

| - 

1 3 I 

| 

1 8 | 

| 

i 6 1 

1 

1 4 I 

1 ** 

1 2 | 


Intrapartition VSAM; 
GET 
PUT 


1 

1 


Figure 8.5-1. (Part 1 of 2) 
CICS/VS Functions 


Average Number of Physical I/Os for 
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CICS/VS functions 


Average number of 
physical I/Os 


Transient Data 


Load a non-resident 
program or map 

- DOS/VS 

- OS/VS 

Note : Figures are minimum 

values. For large programs and programs 

with many RLD items, 

more I/Os may be required. 

Journaling (user and automatic) 


1 

2 


WRITE/PUT STARTI0=YES 
STARTIO=NO 

Where N is the effective 
blocking factor governed 
by the ratio of the 
shift-up value to the 
average journal record 
size. 


1 

1/N 


Figure 8.5-1. (Part 2 of 2) Average Number of Physical I/Os for CICS/VS 
Functions 


CALCULATION OF DISK DEVICE SERVICE TIMES 


The disk service time is used in the next chapter to estimate response 
times. It does not include time spent waiting for service, and is not 
the disk response time . 

To calculate the disk service time, both the disk device itself and 
the combined usage of the disk and channel must be considered. 

For the disk device there are several factors. These are: 

• The time taken to find the correct cylinder - this is known as the 
seek time. On average this is the time taken to traverse one third 
of the number of cylinders over which the data is spread. This is 
often taken as the whole disk and an average time is quoted. 
However, it is often true that there are relatively small, 
frequently used data sets where the total movement is limited to a 
few cylinders. One example is the page data set, which, if the 
reference set is fairly small (say about 250K bytes), would fit on 
one cylinder of a 3330, thus eliminating seek time completely if 
there were no other active data set on that device. 

• The time taken to find the start of the record. This is taken, on 
average, as half the time for one rotation of the disk. 

• The data transfer time, which is equal to the physical record 
length divided by the device data rate. 

Figure 8.5-2 below gives approximate values for these parameters for 
some common devices. 


Chapter 8.5. Physical I/Os 


599 










If RPS (rotational position sensing) is used, a fourth factor is 
brought into account, because when the head is reached by the 
sector that contains the start of the record, the channel must also 
be free. If it is busy, a further revolution will be necessary 
before the record can be read. Thus, several revolutions can take 
place even though the chance of this occuring gets progressively 
less. 

If the channel utilization is "Uc", the average delay due to RPS is 
approximately: 


Average delay = rotation time x Uc/(1-Uc) 


r - - 

|Device 

Minimum|Maximum|Average|Time 
Seek | Seek |Seek |for 1 j 

Time |Time |Time |rotat 

(msec) | (msec) |(msec) |-ion | 

Track| 
CapacJ 
-ity | 

Number 

of 

Tracks 

Number 

of 

Cylind 

-ers 

|Device 
|Capac 

1 “ity 

|Data 
j Rate 
j bytes 
j/sec. 

1 

(K | 

) | 

1 2311 

- 

i 

1 75 
« 

1 25 

■ 

3625| 

10 

200 

] 7.2 

| 156 


|2314/19 

- 

1 

i 

1 

| 60 
i 

I 

1 25 

I 

7294 | 

20 

200 

| 29 

| 312 


|3330-1 

9 

1 

| 45 

i 

i 

| 30 

| 16.8 

1 

13030| 

19 

404 

| 100 

| 806 


J3330-11 

9 

1 

j 47 
■ 

1 

| 30 

| 16.8 
| 

13030| 

19 

808 

| 200 

| 806 


|3340-35 

8 

| 42 

1 

1 25 

i 

| 20.2 

f 

8368 | 

12 

348 

| 34.9 

| 885 


|3340-70 

8 

1 

j 42 

* 

I 

1 2 5 

1 

| 20.2 

a 

8368 | 

12 

696 

| 69.8 

| 885 


|3344 

- 

I 

i 

1 

1 25 

a 

i 

| 20.2 

1 

83681 

12 

2784 

|279.5 

| 885 


| 3350 

L--- 

5 

1 

| 40 

1 

1 25 

| 16.8 

19069| 

30 

555 

| 317.5 

| 1198 

—J 


Figure 8.5-2. Approximate DASD Timing Data 


Notes : 

1. Minimum seek times are times taken to move one cylinder. 

2. Maximum seek times are times taken to move from the first cylinder 

to the last. 

3. Unless specific data is available, the average seek time should be 

used. If active data sets on any device are in one area of the 
disk, the average number of cylinders moved should be assumed to be 
one third of the total spread of the active data sets. Having 
calculated one third of the total spread, the seek time to be used 
can be estimated from Figure 8.5-3. For example, if the total 
spread on a 3330-1 was 150 cylinders, one third would be 50 

cylinders,. Hence, from Figure 8.5-3, the average seek time would 

be approximately 18.5 milliseconds. 

The interaction between the devices and the channel is complex but 
can be calculated approximately assuming that accesses are requested at 
random intervals. 

The channel utilization (Uc) is given by the product of the access 
rate (the sum of the access rates of all the devices on the channel) and 
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the mean channel service time (Tc). The disk service time is then equal 
to the individual device service times (Td) plus the channel wait time. 

The channel utilization, service times, and access rates are found by 
using combined statistics for all the devices on the channel in 
question. This process is best illustrated by a simple example. 

The example assumes random distribution of service times and arrival 
times, which will give slightly pessimistic results in most cases. 

Suppose there are 4 disk drives with 3330-1 devices, with 32 I/Os per 
second spread evenly across the 4 devices. The block size is 3200, and 
the accesses are at random to data sets spread across the whole of each 
device, so that the average seek values in Figure 8.6-2 can be used 
(that is, 30 milliseconds). It is assumed that RPS is not being used. 

The channel will be busy during the rotation delay and the 
transmission time. 

The rotation delay (equal to half a total rotation)=8.4 milliseconds. 

The transmission time is equal to the block size divided by the 
device speed. 


= 3.2 x 10 3 seconds divided by 8.06 x 10 s 
= 3,97 milliseconds 

Hence, the channel service time ("tsc") is 3.97 + 8.4 milliseconds. 

= 12.37 milliseconds 

If the total I/O rate is 32 per second, the channel utilization ("Uc”) 
is: 

32 x (8.4 + 3.97) x 10~ 3 
= 0.396 

Using the equation: 


Channel wait = Uc . tsc 
1 - Uc 

= (0.396 x 12.37)/(1 - 0.396) milliseconds 
= 8.1 milliseconds 

The total device service time is given by: 

Channel wait + rotation delay + seek time + transmission 
time (if RPS=NO) 

Because the channel wait time = 8.1 milliseconds 

rotation delay time = 8.4 milliseconds 

seek time = 30 milliseconds 

transmission time = 3.97 

the total device service time is the sum of these values, that is: 

50.5 milliseconds. 
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| Figure 8.5-3. Approximate DASD Seek Times 
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I Chapter 8.6. 
I 


Host Processor Response and Maximum 
Loading 


I 

I 

| This chapter describes how to use the information that has been given in 
| the preceding chapters of this part of the manual. 


| Apart from an understanding of the amounts of the various resources 
I required and their comparison to available resources, such data is 
j useful as input to a model that can be used to calculate response time 
j as a function of loading. This will enable the system programmer and 
j the system designer to establish the maximum load that is consistent 
| with an acceptable response time, together with the maximum load that is 
| possible for the system (see Figure 8.6-1, below). Variations of the 
| curve can be obtained by varying major parameters (for example, the 
j number of disk devices.) 


I 


I 


Response 

(seconds) 



Figure 8.6-1. Response Times vs. Loading 

A rigorous model of the host processor and its associated processes 
is usually extremely complex. It is not the purpose of the chapter to 
discuss such a model, but to discuss a very simple approximate method 
based on queuing theory. 

It is emphasized that, because of the approximate nature of the 
method and possible inaccuracies in the input data, the absolute results 
produced are unlikely to be accurate . They will, however, be useful for 
predicting the effects of changes and understanding the observed 
behaviour of the system. 

Readers who are familiar with the concepts and practice of queueing 
theory may obtain more accurate estimates of response and loading limits 
by using a more complex model. 

The discussion that follows; 

1. Presents the simple equations that represent the behaviour of the 
system 

2. Discusses the derivation of the input data 

3. Gives a simple example (a more complex one is given in Chapter 8.7) 
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4. Describes an extension to estimate the effect of page-faults 


THE SIMPLE MODEL 


This model can be used to estimate the host processor response time and 
maximum loading. It does not take account of any part of the network 
that is external to the host processor, although the technique can 
reasonably be extended to do this. 

The basic assumptions are that: 

• The host processor can be represented by two single server systems 
- the processing unit and the disk subsystem 

• There is no paging 

• There are no logical queues, for example, VSAM string WAITS 

If the service times and the interarrival times at a single server 
are random, the average time spent waiting for service is given by: 


tq = tsp/(l-p) ...Equation 1.. 

where "ts" is the average service time 
and "p" is the utilization of the server, 

and is given by: 

p = ts/X ...Equation 2. 

where "X” is the interarrival time, which 
is the inverse of the transaction 
rate (R) in our case. 

The average response time is given by: 


tr = ts + tq 

In practice, in a computer system, while arrivals at a server tend to 
be random, service times are more regular and "tq" is given by: 


tq = ts.p.K/(l-p) ...Equation 3. 

where an empirical value of "K" of two-thirds is recommended. 

Variations of between 0.5 and 1.0 can reasonably be expected, depending 
on the system. 

Consider the two major subsystems: 

• The processing unit 

• The disk devices 

If the subscript "c" represents the processing unit, and "d" 
represents the disks, from Equation 3 we have: 
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tq = tqc + tqd 

= (0,67) . tsc.p c/ (1-pc) + (0.67).tsd.pd/(l-pd) 
The average system reponse time is then calculated by 
tr = tqc + tqd + tsc + tsd 


••.Equation 4. 
using the equation 
••.Equation 5. 


DERIVATION OF INPUT DATA 


The input data in question is: 

• Service times for the processing unit and the disks 

• Utilization for the processing unit and the disks 

Average service times ("tsc") for the processing unit are calculated 
by finding the average transaction pathlength and then by dividing by 
the processor speed (refer to Chapter 8.2)• The utilization will then 
be the average service time multiplied by the transaction rate ("R"). 

An addition may be made for background utilization. 

The average service time ("tsd")for the disk subsystem can be found 
by multiplying the single disk service time (see Chapter 8-5') by the 
average number of physical I/Os executed in each transaction. For an 
approximate calculation, the single disk service time can be taken as 40 
milliseconds. If there are "N" disks in frequent use in the subsystem 
and the traffic is spread evenly across the disks, the utilization (pd) 
will be: 


p d = tsd. R/N 

The maximum possible transaction rate (Rmax) on a system is 
determined by the resource that is used-up first; in this case, it is 
the minimum of either: 


I 


1/tsc or N/tsd 

where "N" is the number of disks in active use in the subsystem. These 
are the conditions that "pc" and "pd" are equal to 1. This, of course, 
implies that there are no artificial limits, as for example, AMXT. In 
practice, this limit is seldom achieved because of some unforeseen 
limit. 


If the traffic is not spread evenly across the disks, it will be 
necessary to calculate the maximum load by using the "tsd" value for the 
most frequently used disk, which is found by multiplying the single disk 
service time by the average number of I/Os per transaction to that disk. 


A SIMPLE EXAMPLE 


For the purposes of this example, the system has the following 
parameters: 

• tsc = 0.10 seconds (for example, transaction pathlength=95000 on a 
System/370 model 158-3) 
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| • Average single disk service time = 0.040 seconds 

| • Active data sets are spread over 3 disks 

| • There are 10 physical I/Os per transaction 

j The objective is to calculate the response time as a function of the 
| transaction rate. 

| The maximum load is calculated first. 

| • For the processing unit, the maximum load is 1/tsc: 

| = 1 /( 0 . 10 ) 

j =10 transactions per second 

| • For the disk subsystem, the service time (tsd) is given by: 

| tsd = 10 x 0.040 = 0.4 seconds 

| and the maximum load is: 

| N/tsd 

| = 3/0.4 

j = 7.5 transactions per second. 

j Hence, the maximum possible system rate will be 7.5 transactions per 
| second - that is, the smaller of 10.0 and 7.5. 

| The queue and response times may now be calculated at a variety of 
j transaction rates up to 7.5 transactions per second. 

| Take, for example, a rate of 5 transactions per second. 

| • For the processing unit, using Equation 2 and 3: 

| p c = 5 x 0.10 = 0.5 

| and tqc = 2/3.tsc.oc/(l- p c) 
f = 2/3 x 0.10 x 0•5/(1-0.5) 

| =0.067 seconds 


| • For the disk subsystem. 


pd = 5/3 x 0.40 
= 0.67 

is, tqd = 2/3 x 0.40 x 0.67/(1-0.67) 

= 0.53 seconds. 

| Using Equation 2, the system response time is: 

| 0.53 ♦ 0.40 + 0.067 + 0.10 

I = 1.10 seconds 

j By using the same method, values for 1, 2, 3, 4, 6, and 7 
| transactions per second can be calculated. The results are shown in 
| Figure 8.6-2, below. 


I 

i 

j That 

I 
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R/sec 

|tqc (sec) 

|tqd (sec) 

|tr (sec) 

1 

| 0.007 

| 0.040 

| 0.55 

2 

| 0.017 

| 0.097 

| 0.61 

3 

| 0.029 

| 0.179 

| 0.71 

4 

| 0.045 

| 0.305 

| 0.85 

5 

| 0.067 

j 0.534 

| 1.10 

6 

| 0.101 

| 1.068 

| 1.67 

7 

| 0.156 

| 3.720 

| 4.38 


Figure 8.6-2 Sample Queueing and Response Times 


If, for example, the minimum acceptable response for the processor 
(that is, the total response minus the network contribution) was 1.5 
seconds, the maximum rate would be just over 5.5 transactions per 
second. 

It should be remembered that average response times are being 
discussed. When specifying system requirements, response times are 
sometimes specified as 90% (95%) should be less than "n" seconds”. 
Depending on the distributions, the "90%" value lies between 1.2 and 1.3 
times the average, and the ”95%" value lies between 1.3 and 1.7 times 
the average value. 1.3 and 1.7 respectively are practical values to 
use. 

The above calculation assumes that the different transactions all 
present a similar load on the system. If there is a wide variation of 
transaction service times, individual service times should be calculated 
for each type, and the average queue time should then be added to give 
individual response times. In this case, the 90% and 95% multiplying 
factors will only apply to individual transaction response types, and 
not to the average response . 


TREATMENT OF PAGE-FAULTS 


Some page-faults occur in most systems and so it is necessary to be able 
to quantify their effect. Unfortunately, there is no simple analytic 
technique available that can be used to calculate the probability of a 
page-fault occuring. However, a page-fault rate can either be measured 
or assumed, and having done this the impact of the page-faults can be 
estimated. 

When a page-fault occurs in a CICS/VS partition or region, the whole 
partition or region will wait until the page-fault is resolved. Other 
partitions can continue processing during the I/O time. This has two 
consequences: 

• There will be no queue to the page data set for CICS/VS pages, 

because a second page-fault cannot occur unitl the first has been 
resolved. Hence, for a first approximation, the page-fault 
resolution time can be taken as being independent of the 
transaction rate. This, of course, assumes that no other I/O is 
being performed to the disk that holds the page data set and that 
channel utilization is low. If not, the technique in Chapter 8.5 
should be used to calculate the variation with load. In addition, 
the time taken to execute the instructions used in page-fault 
handling should be added. Refer to Table 2 in Chapter 8.2. 
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• The time that the processor is available to execute "useful" 
instructions is reduced by the product of the resolution time and 
the page-fault rate in every second. 

The previous technique can now be used to calculate the new queuing 
times, because only a new (increased) "pc" value need be calculated. 

This can be used to calculate a new "tqc" value. The page-fault service 
time is then added to give the new response time. 

Consider the previous example, but, in addition, assume that: 

• The page-fault resolution time is 35 milliseconds (refer to Chapter 
8.5 for the methods of estimating this), and the page data set is 
on a fourth disk. 

• The page-fault rate is 10 page-faults per second. 

• The transaction rate is 5 per second. 

Hence, there will be two page-faults per transaction, and the page- 
fault service time per transaction (tsp) will be 0.070 seconds. 

The proportion of the processing unit available for "useful" 
instruction processing in the CICS/VS partition will be: 


1.0 - (0.035 x 10) 

= 0.65 

Hence, the effective utilization at 5 transactions per second with 
"tsc" equal to 0.1 is increased from 0.1 x 5 to (0.1 x 5)/0.65. 

Using Equation 3, 


tqc = 0.10 x 2/3 x 0.77/(1-0.77) 

= 0.224 seconds. 

Adding the page-fault service times and using the new value "tqc". 
Equation 5 gives: 


tr = 0.10 + 0.224 + 0.4 + 0.534 + 0.070 
= 1.33 seconds 

which is an increase of nearly a quarter of a second. 

The other point of interest is that the maximum transaction rate is 
now 6.5 transactions per second, and the limiting factor is the 
combination of the processor and the paging, rather than the disk 
subsystem. 

Increasing the paging rate only slightly above 10 per second would 
cause a large increase in the response time, causing the maximum 
throughput of the system to be decreased, if the limit on acceptable 
response was maintained. 

It should be remembered that if the page-faults are spread over 
several partitions or regions, this technique will overestimate the 
effect because the batch partition(s) could run while CICS/VS was 
waiting for a page fault, and vice versa. 
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Chapter 8 .7. Examples of the Estimation Process 


In order that the reader can see how the estimating techniques that have 
been described in previous chapters are to be used, a complete example 
is given in this chapter, which follows through each of the processes 
described in Chapters 8.2 through 8.6. The processes are: 

• Calculating the processor utilization 

• Calculating virtual storage requirements 

• Calculating real storage requirements 

• Calculating I/O device utilization 

• Estimating response times and maximum loading. 


SYSTEM DEFINITION 

Firstly, the system whose resources are to be estimated is defined, as 
follows: 

• System/370 model 125*2 with 512K bytes using DOS/VS 

• 60 terminals, comprising 50 remote 3277 displays and 10 local 3270 
displays 

• The remote devices are attached through 5 lines 

• CICS/VS Version 1, Release 4 with BTAM, ISAM, and BDAM 

• ICV=5000 milliseconds 

• No batch 


APPLICATION DEFINITION 


Four main transactions are assumed: APPA, APPB, APPC, and APPD. All 
other transactions are used infrequently. Functions used by each 
transaction are given in Table 12, below. These are in addition to the 
BASE function. 
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Functions 


APPA 


APPB 


APPC 


APPD 


BDAM GET 

GET (UPDATE) 

PUT (UPDATE) 

ISAM GET 

GET (UPDATE) 

PUT (UPDATE) 

Transient Data 
PUT 
GET 

BMS 

TYPE=MAP 

TYPE=OUT,DATA=YES 
DATA=NO 
DATA-ONLY 

Subroutine Calls (LINK) 

Additional TC Output 

Application Pathlengths 
(in 1000s) 

Programming Language 


Transaction Rate/Second 
(System total =1.2) 


2 

1 

1 


1 

1 

1 


2 

2 


1 

1 


0.5 


Macro 

assembler 

0.5 


1 

1 

2 

1 

2.0 


Command 

COBOL 

0.2 


1.5 


Macro 

assembler 


0.3 


3.0 


Command 

COBOL 

0.2 


Table 12. CICS/VS Functions for Transactions APPA, APPB, APPC, and APPD 
Notes : 

• BMS maps are composed of 20 fields: 10 data fields and 10 
preformatted fields. On input, an average of 5 fields are 
modified. 

• All message lengths are less than 256 bytes 

• The cylinder indexes of the ISAM files are in main storage 

• It is assumed that the transaction types are spread evenly over the 
different terminals 

• Assume that 1 in 5 transient data PUTS and GETS are the first 
record on a track 


CALCULATE PROCESSOR UTILIZATION 

The process has the following stages: 

1. Calculate the timings of each transaction on the hypothetical 
standard processor 
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2. Calculate the processor utilization for each transaction 

3. Calculate the background processor utilization 

4. Calculate the overall processor utilization 

These stages are discussed in the following sections* 

ESTIMATE THE TRANSACTION TIMINGS 


The base component Ca 0 *) is calculated first. Because there are two 
types of terminals, a weighted average is taken. 

The base component for the remote 3270s is 22 milliseconds; for local 
3270s, 10 milliseconds. 

Because there are 50 remote and 10 local terminals, the weighted 
average is given by: 


Base timing = 5 x 22 + 1 x 10 

6 

- 20 milliseconds 

To this base timing is added the network component, which is given 

by: 


bL + cT + dT/L 

The total number of terminals is 60 and the number of lines is 6. 
(The local 3270s are treated as if they were on one line.) Hence, using 
the values of b, c, and d from Table 3 in Chapter 8.2: 


Network component = 0.120 x 6 + 60 + (0.24) x 10 

= 3.12 milliseconds 

Note : For CICS/VS Version 1, Release 3, this value would have been 5.66 

milliseconds. 

Finally, "a*" values are calculated. Individual function times are 
taken from Table 2 (in Chapter 8.2) and are summed, as below. 
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| APPA 


2 x BDAM GET 

at 

3.0 

each 

= 

6.0 milliseconds 

1 x BDAM GET (UPDATE) 

at 

5.5 

each 

= 

5.5 milliseconds 

1 x BDAM PUT (UPDATE) 

at 

4.3 

each 

= 

4.3 milliseconds 

1 x transient data PUT 

at 

14.28 

each 

= 

14.28 milliseconds 

Application code 




=s 

0.5 milliseconds 

"a 4 " for APPA 




= 

30.58 milliseconds 

APPB 






1 x ISAM GET 

at 

10.50 

each 

= 

10.5 milliseconds 

1 x ISAM PUT (UPDATE) 

at 

14.80 

each 

= 

14.8 milliseconds 

1 X ISAM GET (UPDATE) 

at 

10.50 

each 

= 

10.5 milliseconds 

1 x transient data PUT 

at 

14.28 

each 

= 

14.28 milliseconds 

1 x BMS MAP 

at 

2.40 

each 

= 

2.4 milliseconds 

1 x BMS OUT,DATA=NO 

at 

3.20 

each 

= 

3.2 milliseconds 

1 x BMS OUT,DATA=ONLY 

at 

3.0 

each 

= 

3.0 milliseconds 

2 x LINK + RETURN 

at 

0.42 

each 

= 

0.82 milliseconds 

1 X TC output 

at 

10.78 

each 

= 

10.78 milliseconds 

Application code 




= 

2.0 milliseconds 

Command level COBOL 




= 

10.236 milliseconds 

"a x " for APPB 




= 

82.536 milliseconds 

APPC 






2 x BDAM GET 

at 

3.0 

each 

— 

6.0 milliseconds 

2 x ISAM GET 

at 

10.50 

each 

= 

21.0 milliseconds 

1 x transient data PUT 

at 

14.28 

each 

= 

14.28 milliseconds 

1 X BMS OUT,DATA=YES 

at 

3.90 

each 

= 

3.9 milliseconds 

1 X LINK + RETURN 

at 

0.42 

each 

= 

0.42 milliseconds 

Application code 




= 

0.5 milliseconds 

"aa." for APPC 




= 

46.1 milliseconds 

APPD 






2 x ISAM GET(UPDATE) 

at 

10.50 

each 


21.0 milliseconds 

2 x ISAM PUT(UPDATE) 

at 

14.80 

each 

= 

29.6 milliseconds 

5 x transient data (GET)at 

3.98 

each 

= 

19.9 milliseconds 

1 x LINK 

at 0.42 

each 

= 

0.42 milliseconds 

Application code 




= 

2.0 milliseconds 

Command level COBOL 




= 

8.824 milliseconds 


(see Note 1) 


(see Note 1) 
(see Note 3) 
(see Note 3) 
(see Note 3 


(see Note 5) 
(see Note 4) 


(see Note 3) 


(see Note 2) 


"ai" for APPD 
Notes: 


81.744 milliseconds 


1 . 


2 . 


3. 


Average transient data PUT = 

4 x 11,4 + 1 x 25.8 = 14.28 milliseconds 

“5 

(OS/VS data has been used in place of unavailable DOS/VS data) 

Average transient data GET = 

4 x 3.3 + 1 x 6.7 = 3.98 milliseconds 

5 

(OS/VS data has been used in place of unavailable DOS/VS data) 

For the maps in use, pathlengths are with 10 data fields and 
10 format fields. 


| TYPE=MAP = 2.4 milliseconds (only 5 fields are modified) 
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| TYPE=OUT,DATA=ONLY = 3.0 milliseconds 

| ,DATA=NO = 3.2 milliseconds 

| ,DATA=YES = 3.9 milliseconds 

| 4. For COBOL, add 0.45 milliseconds plus 0.04 per call; for the 

| command level interface, add instructions according to Table 2 

j in Chapter 8.2. 

| 5. Loaded value according to the percentage of remote and local 

j terminals and including the network component (0.5 x 96). 

| Using Equation 2 in Chapter 8.2, (P = a + a ± + bL + CT + (dT/L)), 
| the average values of the timings for each transaction are: 


I 

I 

I 

I 


APPA= 53.7 milliseconds 
APPB= 105.656 milliseconds 
APPC= 69.22 milliseconds 
APPD= 104.864 milliseconds 


| CALCULATE THE TRANSACTION PROCESSOR UTILIZATION 


J From Table 4 in Chapter 8.2, a System/370 Model 125-2 has an average 
j relative power factor of 120. 

\ The total time the processor is busy in each second for each 
| transaction is the processor time ("p") multiplied by the individual 
j transaction rates. The values calculated are shown below. 


j The total time is divided by 120 (the relative power factor) to give a 
j utilization of 0.726 . 


Transaction|Transaction rate/sec.(Time(milliseconds) 


1 

APPA j 

0.5 

1 

| 26.85 

APPB j 

0.2 

| 21.13 

APPC | 

0.3 

| 20.77 

APPD | 

i 

0.2 

| 20.97 

i ... 

1 

Total j 

1 1 

1 CN 

1 • 

1 H 

| 89.72 

1 


| CALCULATE THE BACKGROUND PROCESSOR UTILIZATION 

| The ICV value is 5000 milliseconds (that is, 5 seconds). The number of 
j lines ("L") is 6, and the number of terminals CT") is 60. 

| The pathlength per ICV scan is approximately: 

| P= X + YL + ZT + V (see Equation 4 in Chapter 8.2) 
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In this case, V=0 (VTAM is not used) 
and for DOS/VS X=1.0 
Y^O.05 
Z=0 

Hence, P =1.3 milliseconds 

The intercept value "A" is now calculated from the equation: 


A= 100P/<ICV x F) 

Because F (relative power factor) = 120 

A = (100 x 1.3)/(5000 x 120) = 0.0022 or 0.22% 

Note : For CICS/VS Version 1, Release 3, this value would have been 

0.9%. 

The overall processor utilization is the sum of the previous two 
stages. The value obtained is: 


Utilization = 0.748 + 0.002 
= 0.75 


Expressed as a percentage, this is 75% . 


ESTIMATE THE CICS/VS REFERENCE SET 


The static reference set is calculated first. The superset of all the 
functions used by the four frequently used transactions (APPA, APPB, 
APPC, and APPD) is the list given in Table 12. The BASE functions used 
are BTAM 3270 (local) and 3270 BSC (see Table 1 in Chapter 8.2). 

From the "TOTAL" column in Figure 8.4-1 in Chapter 8.4, the following 
can be seen: 
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r-~-* — 

| Function |Static Reference 

| (Set (K bytes) 

■ i 

-1 

Set | 

i i 

i i 

j BASE (see Note) j 

57 


1 1 

j BMS j 

i i 

8 


1 1 

| Command level | 

j interface | 

i i 

10 


1 1 

| File control | 

| (BDAM/ISAM) | 

i i 

14 


I 1 

| Per file | 

| -2XBDAM j 

2 


| -2x1SAM | 

i i 

2 


1 1 

| COBOL | 

i j 

2 


1 1 

| 6 BTAM lines | 

0.72 


3 I 

| 60 BTAM devices | 

i i 

12 


1 1 

| Transient data | 

i i 

_6 


I 1 

j Total | 

114K bytes 


j (rounded up) | 

L- 


-j 


Notes: 


1. A combination for local and remote is not given in the table. The 
value was obtained by taking the 3270 BSC figure, adding the local 
3270 code size (from DFHTCP virtual storage sizes in Chapter 8.3), 
and calculating the BTMOD size for local and BSC 3270s from the 
DOS/VS System Generation manual. Approximately 2K bytes has been 
added for the CICS/VS part, and IK bytes for BTMOD, making a total 
of 57 k bytes for the BASE. 

2. The "per file" values were estimated from DFHFCT requirements, 
rounded up to the next page boundary. 

If we assume a DOS/VS supervisor size of 64K bytes for this example, 
this would give a total static size of 178K bytes. 

We can now calculate the dynamic requirement. 

The average transaction rate is 1.2 transactions per second, and the 
appropriate host processor response can be calculated to be 
approximately 1.6 seconds. The product of these two values is 
approximately 2.0. To preserve at least a 10:1 chance of not causing 
paging, we need approximately 2.0 x 3, or 6 times the DRS. 

Using Table 12 in this chapter and Figure 8.4-1, the DRS can be 
calculated to be approximately 16K bytes, that is, approximately 96K 
bytes (16 x 6) are needed. If a 4:1 chance is acceptable, we need 
approximately 64K bytes (that is, 2xCxRx DRS). 

Taking the last value, we see that the total requirement is 242K 
bytes, which matches the available storage of 256K bytes. The larger 
value of 96K bytes estimated to be the storage necessary to give about a 
10:1 chance of not encountering a page fault requires 278K bytes. This 


Chapter 8.7. Examples of the Estimation Process 


615 







implies that the system would run reasonably well with only an 
occasional page fault. 


ESTIMATING VIRTUAL STORAGE REQUIREMENTS 


The first step is to choose the approximate example given for operating 
system and access method requirements (Table 6 in Chapter 8.3). 

From this we chose the minimum system with 200K bytes. 

We now calculate the CICS/VS requirements. 

Firstly, resident module sizes. The modules to be used and their 
sizes are taken from Table 7 in Chapter 8.3. These are (in K bytes): 


DFHCSA 4 
DFHKCP 7 
DFHSPP 2 
DFHSCP 6 
DFHPCP (COBOL £ assembler) 5 
DFHTCP 

(Local £ Remote 3270 £ Console Support) 12 
DFHZCP group 2 
DFHSDAM 2 
DFHFCP 6 
DFHTDP 3 
DFHEIP 11 
DFHTRP (Auxiliary) 9 
DFHDCP (Tape) 36 
BMS (Minimum 3270) 6 

Module Total 111K bytes 


Note : All modules have been rounded to the next K bytes for ease of 

calculation since we are only interested in an approximate figure for 
virtual storage. 

The next set of sizes belongs to CICS/VS programs residing in the 
PPT. We assume that all these programs will be made resident in virtual 
storage. 

The basic sets of modules are (in K bytes): 


DFHJxx - Journaling 8 
DFHMTxx - Master Terminal 56 
DFHSTxx - Statistics 24 
DFHTAxx - Terminal Abnormal Condition Program 6 
DFHOCP - Dynamic Open/Close Program 3 

Module Total 97K bytes 


It is now necessary to estimate the size of the CICS/VS tables. The 
major tables are: 


DFHPCT, DFHPPT, DFHFCT, DFHDCT, DFHTCT and DFHTRT 

For the purposes of this example, we will assume that, including 
required entries, the numbers of entries and sizes (rounded to the page 
size) are (in K bytes): 
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DFHPCT 

50 

entries 


4 

DFHPPT 

80 

entries (10 COBOL) 

6 

DFHFCT 

10 

files (5 BDAM, 5 

ISAM) 

12 

DFHDCT 

16 

destinations 


6 

DFHTCT 

60 

terminal entries 

6 BTMOD 

26 

DFHTRT 

500 

entries 


8 


Module Total 62K bytes 


The next step is to estimate the size of the application programs and 
maps. It will be assumed that they are all resident in virtual storage 
and that the total size is 120K bytes. 

The final step is to calculate the dynamic storage area size. MXT 
(the limit on the number of simultaneous tasks) is assumed to be 10. 

For the most frequently used transactions (APPA, APPB, APPC and APPD) 
the maximum storage used is assumed to be 12K bytes for the purposes of 
this example. Hence a DSA of 12OK bytes would be adequate. In 
addition, an allowance of 16K bytes is made for the storage cushion, 
giving a total of 136K bytes. 

In summary we have (in K bytes )2 


System 

200 

Nucleus 

111 

Other CICS/VS Modules 

97 

Tables 

62 

Applications 

120 

DSA 

136 


726K bytes 


Since the cost of having too little virtual storage is far greater 
than having too much, the total size should be increased by about 10%, 
as a contingency, to 80OK bytes . 


ESTIMATE THE NUMBER OF PHYSICAL I/Os AND THE DEVICE SERVICE 
TIMES 


Here we use Figure 8.5.1 and calculate the number of I/Os for each 
transaction according to the functions invoked by each one. 


APPA 

9 

I/OS 

(Note: Each transient data PUT averages 4 I/Os 

for the environment of this example) 

APPB 

7 

I/OS 


APPC 

7 

I/Os 


APPD 

27 

I/OS 



Multiplying each of these by the transaction rates and summing them, we 
see that the total I/O rate is 13.4 per second. 

For the purposes of this example, because 8 1/os per second are to 
the transient data destinations, we assume that 8 I/Os per second go to 
a single disk and that the other 5.4 per second are spread over two 
further devices. The devices are 3340s with a capacity of 70M bytes. 

For the transient data device we make the assumption that the data 
sets only spread across 3 cylinders, giving an average seek time of only 
8 milliseconds. On the other two devices, we take the average seek time 
of 25 milliseconds. The rotation delay is 10.1 milliseconds in both 
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cases. The average record length (for this example) is assumed to be 
512 bytes in all cases, so that the average transfer time is 0.5/885 
seconds, that is, approximately 0.45 milliseconds. 

The channel service time ("tsc") is thus: 10.1 + 0.45 = 10.6 
milliseconds. Since the total channel rate is 13.4 seconds, the channel 
utilization CUc") is: 


13.4 x 10.6 x 10-3 = 0.142 

Using the equation: Channel wait = tsc x Uc/(1-Uc) 

= 10.6 x 0.142 
0.858 

= 1.75 milliseconds. 

Hence, for the transient data device, the service time is 10.6 + 1.75 
+ 8.0 = 20.35 milliseconds. For the other devices, the service time is 
10.6 + 1.75 + 25.0 = 37.35 milliseconds. 


ESTIMATING THE APPROXIMATE RESPONSE TIME 


An approximate value of the average response time for the system is now 
calculated using the simple method described in Chapter 8.6 

The average processor service time = Processor utilization/transaction 

rate per second 
= 0.75/1.2 
= 0.625 seconds. 


Hence the processor queue time "tqc" = 

0.67 x 0.75 x 0.625 
1-0.75 

= 1.26 seconds 


The average disk queue time is calculated as follows: 

The average service time "tsd" = 

8 x 37.35 + 5.4 x 20.35 
13.4 

= 30.5 milliseconds 
= 0.0305 seconds 


The utilization is given by "tsd" x disk access rate/number of disks 

= 0.0305 x 13.4/3 
= 0.136 

Since the average disk access per transaction is 13.4/1.2 = 11.2 per 
transaction, the average disk service time for each transaction is: 
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11.2 x 30.5 = 341.6 millisecond 
= 0.342 seconds . 

Hence, "tqd" = 0.67 x 0.342 x (0.136/1-0.136) 

= 0.036 

so that the average disk response is 0.342 + 0.036 = 0.38 seconds. 

Hence, the average response in the processor is given by: 

tr = trc + trd 

=.. 1.26 + 0.625 +0.38 

= 2.27 seconds 

This calculation has assumed no page faults. Due to the relatively 
high processor utilization, the impact of page faults will be quite 
high. 

Taking the very approximate value of 25 milliseconds to resolve a 
page fault, we can see that even if the system only suffered 6 page 
faults per second, the processor "q" times would be dramatically 
increased because only 850 milliseconds in each second would be 
available for useful work, and the utilization would become 
approximately 88%, making the queue time equal to: 


0.67 x (0.88/1-0.88) x 0.625 
= 3.07 seconds 

Adding the contribution to the response due to the page faults, the 
overall response would become about 4.2 seconds , an increase of about 
1.9 seconds. 
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Appendix A. Required Entries in CICS/VS 

Control Tables 


This appendix describes the entries that are required in the following 
CICS/VS control tables: 

• Destination control table 

• Program control table (required entries and entires for optional 
features) 

• Processing program table. 


DESTINATION CONTROL TABLE 


The following destination identification entries are required. CSMT, 
CSTL, CSSL, and CSML must be specified by the user in the DFHDCT 
TYPE=EXTRA, DFHDCT TYPE=INTRA, or DFHDCT TYPE=INDIRECT macro, and CSSM 
and CSSN must be specified in the DFHDCT TYPE=EXTRA macro with 
OPEN=DEFERRED. 


I 


1. DESTID=CSMT 

2. DESTID=CSTL 

3. DESTID=CSSL 

4. DESTID=CSML 

5. DESTID=CSSM 
DESTID=CSSN 


The terminal abnormal condition program (DFHTACP), 
node abnormal condition program (DFHZNAC), 
and abnormal condition program (DFHACP) write 
terminal error and ABEND messages, respectively, 
to this destination. 

DFHTACP writes terminal I/O error messages to 
this destination. 

Statistics programs write data to this 
destination. 

Sign-off program outputs data to this destination. 
The automatic statistics program writes data 
to these destinations. The automatic statistics 
program requires that the CSSM and CSSN DCT 
entries are specified in DFHDCT TYPE=EXTRA, 
with a final destination of either a tape 
or a disk device. 


Note : The above entries may not be specified, either directly or 

indirectly, as logically recoverable intrapartition destinations. These 
destinations must always be enabled. If any are defined as indirect 
destinations, their final target destination must also always be 
enabled. 


The destinations CSMT, CSTL, CSSL, and CSML require a minimum logical 
record size of 125. The destinations CSSM and CSSN require a minimum 
logical record size of 304. These entries are only required when the 
automatic statistics program is to be used. Only CSSM is required if no 
switching is to be done between the statistics data sets. If the 
transient data control program (DFHTDP) is not included in the 
generation of CICS/VS, messages to these destinations are ignored. 

The entry for CSSM should read: 
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DFHDCT TYPE-EXTRA,DESTID=CSSM, * 

DSCNAME-DFHSTM 
| OPEN=DEFERRED 

and must be preceded by: 


DFHDCT TYPE=SDSCI,DSCNAME=DFHSTM, * 

BLKSIZE=, * 

RECSIZE=, * 

RECFORM=, * 

TYPEFLE=OUTPUT 

The entry for CSSN should read: 

DFHDCT TYPE=EXTRA,DESTID=CSSN, * 

DSCNAME=DFHSTN 
| OPEN=DEFERRED 


and must be preceded by: 


DFHDCT TYPE=SDSCI,DSCNAME=DFHSTN, * 

BLKSIZE=, * 

RECSIZE=, * 

RECFORM=, * 

TYPEFLE=OUTPUT 


I Note : If these DSCNAMEs (DFHSTM and DFHSTN) are used, an MNOTE message 
j ("DSCNAME SHOULD NOT USE "DFH" PREFIX") will be issued. This message 
I can be ignored. 

If the PL/I Optimizer-supplied PL/I-CICS/VS support is to be 
installed, destinations CPLI (SYSPRT output) and CPLD (PLIDUMP output) 
will also be required. The minimum logical record size for CPLI is 133, 
and 125 for CPLD. If the destinations are extrapartition (direct or 
indirect), they must be V format. See the PL/I Optimizer Installation 
Manual for further details. 


PROGRAM CONTROL TABLE 

| The following entries for CICS/VS-supplied transaction names may be 

required in the PCT depending on the particular CICS/VS system generated 
| and can be provided through the DFHPCT TYPE=ENTRY macro instruction if 
| the system programmer wishes to override the entries that are provided 
j by the FN operand of the DFHPCT TYPE=GROUP macro. 
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TRANSID 

PROGRAM 

DFHPCT 

CLASS= 

TPURGE 

See 



TYPE= 


and 

Notes 



GROUP, 

FN= 


SPURGE= 

Below 


CAQP 

DFHAQP 

ATP 

SHORT 

NO 


CATP 

DFHATP 

ATP 

LONG 

NO 


| CAUT 

DFHSTSP 

AUTOSTAT 

SHORT 

NO 


CMSG 

DFHMSP 

MSWITCH 

SHORT 

YES 

4 

CRDR 

DFHRD1 

ATP 

LONG 

NO 


CSAC 

DFHACP 

STANDARD 

SHORT 

NO 

7,8 

CSCY 

DFHCPY 

VTAMPRT 

SHORT 

YES 

11,12 

CSFE 

DFHFEP 

FE 

LONG 

YES 

8 

| CSGM 

DFHGMM 

VTAM 

SHORT 

YES 


CSJC 

DFHJCBSP 

JOURNAL 

LONG 

NO 


CSKP 

DFHAKP 

AKP 

SHORT 

NO 


CSLG 

DFHZRLG 

RESPLOG 

LONG 

NO 

8,10 

CSMI 

DFHMIR 

ISC 

SHORT 

YES 

14 

CSMT 

DFHMTPA 

MASTTERM 

LONG 

NO 

8,9 

CSNC 

DFHCRNP 

ISC 

LONG 

NO 

13 

| CSNE 

DFHZNAC 

VTAM 

SHORT 

NO 

5 

CSOT 

DFHMTPA 

MASTTERM 

LONG 

YES 

8,9 

CSPG 

DFHTPR 

BMS 

SHORT 

NO 


CSPK 

DFHPRK 

VTAMPRT 

SHORT 

YES 

11,12 

CSPP 

DFHP3270 

HARDCOPY 

SHORT 

YES 

11,12 

CSPQ 

DFHTPQ 

BMS 

SHORT 

NO 


CSPS 

DFHTPS 

BMS 

SHORT 

NO 


CSRK 

DFHRKB 

VTAMPRT 

SHORT 

YES 


CSRS 

DFHZRSP 

RESEND 

LONG 

NO 

6,10 

| CSSF 

DFHSNP 

SIGNON 

SHORT 

YES 

7,8 

j CSSN 

DFHSNP 

SIGNON 

SHORT 

YES 

7,8 

CSST 

DFHMTPA 

MASTTERM 

LONG 

YES 

8,9 

CSTA 

DFHTAJP 

TIME 

SHORT 

YES 


CSTE 

DFHTACP 

STANDARD 

LONG 

NO 


| CSTT 

DFHSTKC 

STANDARD 

LONG 

NO 

8,9 

CSXX 





2 

CWTO 

DFHCWTO 

CONSOLE 

LONG 

YES 

(DOS/VS only) 

CWTR 

DFHWT1 

ATP 

LONG 

NO 


8888 

DFHSNP 

NUMERICS 

SHORT 

YES 

1 

9999 

DFHSNP 

NUMERICS 

SHORT 

YES 

1 

User-name 

Us er-supplied 



3 


Certain transactions beginning with the characters "CSD" may be required 
if the system is running with DL/I DOS/VS. Refer to the DL/I 
publications for details of these transactions. 

Notes : (see foregoing table) 

* The TWASIZE need not be specified for the system transactions listed 
above. DFHPCT will automatically supply the minimum TWASIZE 
necessary for the transaction. A value need only be specified if 
extra private space is required. 

1. Entries are only required when numeric-only terminals are used to 
sign on. 

| 2. Transaction code CSXX is reserved for 3270 support and should not 

j be generated in the PCT. It is used by CICS/VS to generate an 

| "invalid transaction code" message when a zero length data message 

| is received. 

| 3. Any transaction codes specified for the TRANSID parameter in any 

| DFHTCT TYPE=TERMINAL macro instruction must be included in the PCT. 
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4* The TRANSID for CICS/VS message switching program (DFHMSP) can be 
CMSG or any four character code chosen by the user to replace CMSG. 
TRANSID=CMSG orFN=MSWITCH also generates the BMS group of 
transaction identifications. 

5. The CICS/VS-supplied TWASIZE for CSNE is a minimum. It must be 

increased to between 60 and 140 bytes (depending on the options 

specified) if the sample NEP is used, or increased to the extent of 
any additional user requirements. 

6. The TWASIZE for CSRS may be increased by user requirements. 

7. For transaction codes CSAC, CSSN, and CSSF, the value of the user- 

assigned transaction security key must be 1. 

8. For transaction codes CSAC, CSFE, CSTA, CSMT, CSOT, CSST, and CSLG, 
a high priority (such as 255) is recommended. For transaction 
codes CSSF, CSSN, and CSTT, a low priority (such as 1) is 
recommended. These priorities are set automatically by the 
appropriate DFHPCT TYPE=GROUP macros. 

9. Transaction codes CSMT, CSOT, CSST and CSTT, cannot be used in 2260 
compatability mode; specify COMPAT=NO or omit the operand. 

10. Transaction codes CSNE, CSLG, and CSRS, must be defined as VTAM- 
only transactions (DVSUPRT=VTAM in DFHPCT macro). 

11. When purged, a message could be lost. 

12. CSPP is required for hard copy support (PRINT=PAl, PA2, PA3, or YES 
in DFHSIT) for VTAM and BTAM 3270. CSCY, CSPK, and CSRK are 
required for PRINT=PA1, PA2, or PA3 for VTAM 3270. CSPK is 
required for 3270 compatibility mode. 

13. TRANSID=CSNC is only required for DL/I shared data base support 
under CICS/OS/VS. 

14. Transaction code CSMI provides the CICS/VS mirror module for 
intersystem communication support and for DL/I shared data base 
support in CICS/OS/VS. 


PROGRAM CONTROL TABLE (OPTIONAL FEATURES) 

The following entries are required if dedicated PA and/or PF keys are 
used with the single keystroke retrieval feature of BMS, i.e., if the 
extended option for single keystroke retrieval is used. 

TASKREQ PROGRAM TWASIZE CLASS TPURGE/SPURGE 

key-id DFHTPR 640 SHORT NO/NO 

| The valid key-ids are PAl through PA3 and PFl through PF24. 

| The following entries are required if the execution (command level) 
j diagnostic facility (EDF) is to be used: 


TRANSID/TASKREQ 

PROGRAM 

TWASIZE 

CLASS 

TPURGE/SPURGE 

CEDF 

DFHEDFP 

120 

LONG 

YES/YES 

key-id 

DFHEDFP 

0 

SHORT 

YES/YES 
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| It is anticipated that a security key would be specified for each of 
j these entries. 


| Valid key-ids are PF1 through PF24. The TWASIZE need not be 
| specified. 


PROCESSING PROGRAM TABLE 


The following entries are required in the PPT and can be provided 
through the DFHPPT TYPE=ENTRY macro instruction if the system programmer 
wishes to override the entries that are provided by the FN operand of 
the DFHPPT TYPE=GROUP macro: 


PROGRAM 

NAME 

DFHPPT TYPE 
=GROUP.FN= 

USAGE 

DFHACP 

STANDARD 

Abnormal condition program. 

DFHAKP 

AKP 

Activity keypoint program for recovery/restart. 

DFHAQP 

ATP 

Asynchronous queue purge program (required only 
if the asynchronous transaction processing 
facility is being used). 

DFHATP 

ATP 

Asynchronous transaction control program 
(required only if the asynchronous transaction 
processing facility is being used). 

DFHBMSMM 


Basic mapping support program (required only if 
programs or maps from a previous version of CICS 
are still being used). If these programs and 
maps are recompiled and linked under CICS/VS, 
DFHBMSMM is not required. 

DFHCPY 

DFHEXI 

DFHPRK 

DFHRKB 

PRINT 

Terminal Control Print Key Support programs 
(required only if DFHSG PROGRAM=TCP, 

VTAMDEV=3270, DFHSIT PRINT=PAl, PA2, or PA3, 
or 3270 compatibility mode are specified). These 
are part of the support generated when 

VTAMDEV=3790 or LUTYPE2 is specified. 

DFHCRNP 

DFHCRSP 

ISC 

Inter-region new connection program and 
inter-region control initialization program 
(DL/I shared data base support under CICS/OS/VS) 

DFHCWTO 

CONSOLE 

Terminal to processor console terminal message 
switching program. 

For CICS/DOS/VS only, and is optional. 

DFHDBPxx 

BACKOUT 

Dynamic transaction backout program. The PPT 
entry must correspond to the DBP=xx entry in 
DFHSIT. DFHPPT TYPE=GROUP,FN=BACKOUT will 
produce the pregenerated version of the program 
(DFHDBP1$). 

DFHEDFD 

DFHEDFF 

DFHEDFM 

DFHEDFP 

DFHEDFR 

EDF 

Execution (command level) diagnostic facility 
(EDF) display program (when EDF is desired) 

EDF function description table 

EDF map set 

EDF control program 

EDF response table 
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PROGRAM 

NAME 


DFHEDFX 

DFHFEP 

DFHGMM 

DFHJCBSP 

DFHJCC 

DFHJCEOV 

DFHJCI 

DFHJCIOE 

DFHJCKOJ 

DFHJCO 

DFHJGSDJ 

DFHMIR 


DFHMSP 


DFHMTPA 

DFHMTPB 

DFHMTPC 

DFHMTPD 

DFHMTPE 

DFHMTPF 

DFHMTPG 

DFHOCP 


DFHPEP 


DFHPLTxx 


DFHP3270 


DFHRD1 

DFHRD2 


DFHRTY 


DFHRUP 

DFHSFP 


DFHSNP 


DFHPPT TYPE USAGE 
=GROUP,FN= 


EDF task switch program 

FE Terminal test program (optional) 

VTAM CICS/VS VTAM "good morning" message program 

JOURNAL Journal tasks ’boot strap* program 

Journal control close program 
Journal control EOV program 
journal control input program 
Journal control I/O error program 
Kick-off journal control program 
Journal control open program 
Shutdown journal control program 

ISC Intersystem communication and DL/I shared data base 

(OS/VS only) mirror program 

MSWITCH Message switching program (only required 

if message switching is being used). 

MASTTERM Master terminal program (only required if master 

terminal or system termination functions are 
desired!). 


OPENCLSE Dynamic open/close program (only required if 

dynamic open/close facility is desired). 

; Program error program linked to by DFHACP. 

This can be the dummy program error program, 
user-written program error program, or can 
be omitted entirely, 

, An entry for each program list table generated 

by the user with the DFHPLT macro instruction. 

HARDCOPY Terminal control program print application program. 

Required if DFHSIT,PRINT=YES, PA1, 

PA2, or PA3 is specified. 

ATP Asynchronous transaction input processing 

programs (only required if the asynchronous 
transaction processing facility is being used). 

Transaction restart, for use with the 
dynamic transaction backout facility. 

This can be user-written, the CICS/VS-supplied 
sample version, or can be omitted. 

RECOVERY Recovery utility program for recovery/restart. 

SIGNON Sign-off program linked to by DHFSNP (only 

required if sign-on/sign-off function is desired). 

SIGNON Sign-on program (only required if sign-on/sign- 

off function is desired). 
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PROGRAM 

NAME 

DFHPPT TYPE 
=GROUP_FIfe 

USAGE 

DFHSNT 

SIGNON 

Sign-on table (only required if sign-on/sign-off 
function is desired). 

DFHSTKC 

STANDARD 

Supervisor statistics program. 

DFHSTLK 

STANDARD 

ISC Link statistics program. 

DFHSTP 

STANDARD 

System termination program linked to by DFHMTP. 

DFHSTPD 

STANDARD 

Program and dump statistics program linked to 
by DFHSTKC. 

DFHSTSP 

AUTOSTAT 

Automatic statistics summarization control program. 

DFHSTTD 

STANDARD 

Data management statistics program linked to by 
DFHSTKC. 

DFHSTTR 

STANDARD 

File and terminal statistics program linked 
to by DFHSTKC. 

DFHTACP 

STANDARD 

Terminal abnormal condition program. 

DFHTAJP 

TIME 

Time adjustment program that automatically adjusts 
the data and time of day maintained by CICS/VS 
to reflect the date and time of day maintained by 
the operating system. 

DFHTBP 

RECOVERY 

Transaction backout program. 

DFHTDRP 

RECOVERY 

Transient data recovery program for recovery/restart. 

DFHTEP 

STANDARD 

Terminal error program linked to by DFHTACP. 

This can be the dummy terminal error program 
provided during the generation of the control 
system operational group, a generated version of 
the sample terminal error program provided with 
CICS/VS, or a user-written terminal error program. 

DFHTEPT 


Terminal error program table (only required if 
a generated version of the sample terminal error 
program provided with CICS/VS is used). RES=YES 
should be specified in the PPT entry for DFHTEPT. 

DFHTLTxx 

— 

An entry for each terminal list table generated 
by the user with the DFHTLT macro instruction. 

DFHTPQ 

MASTTERM 
or BMS 

Basic mapping support program (only required 
if CICS/VS basic mapping support is being used). 

DFHTPR 

MASTTERM 
or BMS 

Basic mapping support program (only required if 
CICS/VS basic mapping support is being used). 

DFHTPS 

MASTTERM 
or BMS 

Basic mapping support program (only required if 
CICS/VS basic mapping support is being used). 

DFHTRNxx 

— 

Nonresident data set control blocks as specified 
by the user in DCT. (Specify RELOAD=YES for each.) 

DFHTSRP 

RECOVERY 

Temporary storage recovery program. 


Appendix A. Required Entries in CICS/VS Control Tables 


627 




PROGRAM DFHPPT TYPE USAGE 
NAME =GROUP.FN= 


DFHUAKP 

DFHWT1 ATP 
DFHWT2 

DFHXITxx 

DFHXLTxx 


User Activity Keypoint Program linked to by 
DFHAKP. This can be a user-supplied program 
or can be omitted entirely. 

Asynchronous transaction output processing 
programs (only required if the asynchronous 
transaction processing facility is being used). 

User-written exit routine used with asynchronous 
transaction processing transactions CRDR and CWTR. 

An entry, for each transaction list table generated 
by the user with the DFHXLT macro instruction. 


DFHZNAC VTAM 
DFHZNEP VTAM 

DFHZRLG RESPLOG 


Node abnormal condition program. 

Node error program linked to by DFHZNAC. This is 
either the interface module generated by the 
DFHZNEPI macro, or the only user-written node 
error program. 

Response logging program. Required for VTAM. 


DFHZRSP RESEND 


User- 

specified 

name 


Resend program. Required for VTAM support if 
message resynchronization requires retransmission 
of any in-doubt committed output message (See 
"Message Recovery and Resynchronization" in 
Chapter 4.8.) 

User-written program to edit input data and 
transfer control to the appropriate transaction. 


User- — The names of any recovery programs from the 

specified system recovery table. 

name 


User- 

specified 

name 


An entry is required for each mapset name for 
for input and output basic mapping support 
operations. The RELOAD=YES option of the PPT 
must not be used with BMS maps. 


User- 

specified 

name 


An entry is required for each user node error 
program as specified by the DFHZNEP module 
generated by the DFHZNEPI macro. 


The following entries are required if the PL/I Optimizer-supplied 
PL/I-CICS/VS support is to be installed. See the PL/I Optimizing 
Compiler: Installation manual for details. 


IBMBCCLA, IBMBCCRA (OS/VS only), IBMBEOCA, IBMBETAA, IBMBETBA, IBMBETCA, 
IBMBETIA, IBMBETOA, IBMBETPA, IBMBETQA, IBMBETTA, IBMDCCRA (DOS/VS 
only), IBMFEFCA, IBMFESMA, IBMFESNA, IBMFKCSA, IBMFKMRA, IBMFKPTA, 
IBMKTBA, IBMFKTCA, IBMFKTRA, IBMFPGDA, IBMFPMRA, IBMFSTVA. 


These entries may be generated as a functional group through the 
FN=PL/I operand of DFHPPT TYPE=GROUP. 


Records to define such entries are provided as part of the PL/I 
installation information. 
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Appendix B. Examples of Terminal Control Table 

Preparation 


This section illustrates the coding required to prepare the CICS/VS 
terminal control table (TCT). The terminal network described includes: 


I 

I 


I 

I 

I 

I 


I 

I 

I 


I 

I 


I 


I 


1. Start/stop transmission 

a. Multipoint line (serving one or more terminals) 

(1) 1050 Data Communication System under CICS/DOS/VS 

(2) 2260 Display Station (Remote) under CICS/DOS/VS 

b. Point-to-point line (serving only one terminal) 

(1) 2740 Communication Terminal under CICS/DOS/VS 

(2) 2741 Communication Terminal with correspondence code 
under CICS/DOS/VS 

c. Switched line (dial-up) 

(1) 7770 Audio Response Unit under CICS/OS/VS via local 
attachment 

(2) 7770 Audio Response Unit under CICS/DOS/VS via local 
attachment 

(3) Teletypewriter Exchange Terminal (CPT-TWX) under 
CICS/DOS/VS 

(4) Teletypewriter (WTC only) under CICS/DOS/VS 

2. Binary synchronous transmission 

a. Multipoint line (serving one or more terminals) 

(1) 2980 General Banking Terminal System under CICS/OS/VS 

(2) 3270 Information Display System (remote) under CICS/OS/VS 

(3) 3740 Data Entry System under CICS/DOS/VS 

(4) 3780 Data Communication Terminal under CICS/OS/VS 

(5) 3600 Finance Communication System under CICS/OS/VS 

b. Point-to-point (serving only one terminal) 

• 2780 Data Transmission Terminal 

c. Switched line (dial-up) 

(1) 2770 Data Communication System under CICS/OS/VS 

(2) System/3 under CICS/OS/VS 

(3) 3275 Display Station under CICS/DOS/VS 

(4) 3735 Programmable Buffered Terminal under CICS/OS/VS 

(5) 3740 Data Entry System under CICS/DOS/VS 

(6) 3740 Data Entry System under CICS/OS/VS 

3. Transmission via sequential devices under CICS/DOS/VS 

a. Card reader/line printer 

• 2540 Card Read Punch and 1403 Printer 

b. Disk 

• 2314 Direct Access Storage Facility 

c. Processor console as a terminal 

4• Transmission via devices locally attached 
a, Graphics devices 

(1) 3270 Information Display System (local) under CICS/OS/VS 

(2) 2260 Display Station (local) under CICS/DOS/VS 

5. SDLC /SNA terminals 

Examples of TCT generation for terminals connected via VTAM 

6. Additional examples for terminals connected via TCAM. 

7• Intersystem communication 
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8. DL/I Shared Data Base Support (CICS/OS/VS) 


Each of the following is a functional example if, as shown in the 
first example, (1) the DFHTCT TYPE=INITIAL macro instruction is inserted 
at the beginning of each example, (2) the DFHTCT TYPE=FINAL macro 
instruction is inserted at the end of each example. 


| 1050 DATA COMMUNICATION SYSTEM (MULTIPOINT UNDER CICS/DOS/VS) 

DFHTCT TYPE=SDSCI, * 

DEVICE=1050, * 

LINELST=(030), * 

DSCNAME=DTF50MD, * 

CU=2703, * 

SWITCH=NO 

OPL1050 DFTRMLST OPENLST,(620B,620D,640B) 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=1050, * 

DSCNAME=DTF5 OMD , * 

INAREAL=80, * 

BTAMRLN=1, * 

LISTADR=OPLl050 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T50A, * 

TRMPRTY=10, MOD 5 INDICATES KEYBOARD * 

TRMMODL= 5, * 

TRMTYPE=1050, * 

TRMADDR= 6202, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T56A, * 

TRMPRTY=10, * 

TRMMODL=6, MOD 6 INDICATES 1056 READER * 

TRMTYPE=1050, * 

TRMADDR=6202, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T50 B, * 

TRMPRTY=10, * 

TRMMODL=5, * 

TRMTYPE=1050, * 

TRMADDR= 6413, * 

TRMSTAT=TRANSCEIVE, * 

LASTTRM=LINE 


CICS/VS System Programmer"s Reference Manual 


630 



| 2260 DISPLAY STATION (REMOTE/MULTIPOINT UNDER CICS/DOS/VS) 


DFHTCT TYPE=SDSCI, * 

CU=2701 f * 

DEVICE=2260, * 

LINELST=(026), * 

SWITCH=NO, * 

DSCNAME=DTF6 OR * 

OPL2260 DFTRMLST OPENLST,(40FF,41FF) 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE= 2260, * 

TRMMODL=C, * 

DSCNAME=DTF6 OR, * 

BTAMRLN=1, * 

LISTADR=OPL2260, * 

INAREAL=960 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R60A, * 

TRMADDR= 4 0A 0, * 

TRMPRTY=61, * 

trmstat=Transceive 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R60B # * 

TRMADDR= 4 0 Al, * 

TRMPRTY=62, * 

TRMSTAT=TRANSCEIVE * 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R530, * 

TRMTYPE=1053, * 

TRMADDR=40A4, * 

TRMPRTY=32, * 

TRMSTAT=RECEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R65A f ♦ 

TRMTYPE=2265, * 

TRMADDR=4151 f * 

TRMPRTY= 64, * 

TRMSTAT= TRAN SCEIVE, * 

LASTTERM=LINE 
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I 2740 COMMUNICATION TERMINAL (POINT-TO-POINT NON-SWITCHED WITH 
j VRC/LRC CHECKING UNDER CICS/DOS/VS) 


DFHTCT TYPE=SDSCI, * 

CU=2703, * 

DEVICE=2740, * 

FEATURE=(CHK), * 

LINELST=(029), * 

SWITCH=NO f * 

DSCNAME=DTF40B 

DFHTCT TYPE=LINE, * 

AC CMETH= BTAM, * 

TRMTYPE=2740, * 

FEATURE=CHECKING, * 

DSCNAME=DTF40B, * 

INAREAL=120, * 

BTAMRLN=1 

DFHTCT TYPE= TERMINAL , * 

TRMIDNT=T40C, * 

TRMPRTY=202, * 

TRMSTAT=TRANSCEIVE, * 

LASTTRM=LINE 


| 2741 COMMUNICATION TERMINAL (POINT-TO-POINT NON-SWITCHED WITH 
j CORRESPONDENCE CODE UNDER CICS/DOS/VS) 


DFHTCT TYPE=SDSCI, * 

CU=2703, * 

DEVICE=2741C, * 

LINELST=(030), * 

SWITCH=NO, * 

DSCNAME=DTF 41C 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM , * 

TRMTYPE=2741C, * 

DSCNAME=DTF41C, * 

INAREAL=120, * 

BTAMRLN=1 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T41A, * 

TRMPRTY=129, * 

TRMSTAT=TRANSCEIVE, * 

LASTTRM=LINE 
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7770 AUDIO RESPONSE UNIT (SWITCHED UNDER CICS/OS/VS) 


DCB DFHTCT TYPE=SDSCI, * 

DEVICE=7770, * 

DSCNAME=DCB7770, * 

APPENDG=Z3 

L17770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=777 0, * 

DSCNAME=DCB 7770, * 

INAREAL= 256, * 

BTAMRLN=1 f 
FEATURE=AUTOANSR, 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 

ERRMSG=ERROR, * 

POOLADR=Tl7770 

L27770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=777 0, * 

DSCNAME=DCB7770, * 

INAREAL=256, * 

BTAMRLN=2, * 

FEATURE=AUTOANSR, * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 

ERRMSG= ERROR 

L37770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7 77 0, * 

DSCNAME=DCB7770, * 

INAREAL=2 56, * 

BTAMRLN= 3, * 

FEATURE=AUTOANS R, * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 

ERRMSG=ERROR 

L47770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770, * 

DSCNAME=DCB7770, * 

INAREAL= 256, * 

BTAMRLN= 4, * 

FEATURE=AUTOANSR, * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 

ERRMSG=ERROR 

T17770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7771, * 

TRMPRTY= 30, * 

TRMTYPE=7770, * 

TRMSTAT=TRANSCEIVE 

T27770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7772, * 

TRMPRTY= 30, * 

TRMTYPE=7770, * 

TRMSTAT= TRAN SCEIVE 
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T37770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7773, * 

TRMPRTY= 30, * 

TRMTYPE=7770, * 

TRMSTAT= TRANSCEIVE 

T47770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7774, * 

TRMPRTY=30, * 

TRMTYPE=7 770, * 

TRMSTAT= TRAN SCEIVE, * 

LASTTRM= POOL 

READY DFHTCT TYPE=7770MSG, * 

MESSAGE 31 * 001D0B * 

ERROR DFHTCT TYPE=7770MSG, * 

MESSAGE='000A0F* 

| 7770 AUDDIO RESPONSE UNIT (SWITHCED UNDER CICS/DOS/VS) 

DTF DFHTCT TYPE=SDSCI, * 

DEVICE=7 770, * 

DSCNAME=DTF7770, * 

SWITCH=YES, * 

LINELST=(080,081,082,083), * 

BLKSIZE=256 

L17770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770, * 

DSCNAME=DTF7770, * 

INAREAL=256, * 

BTAMRLN=1, * 

FEATURE=AUTOANSR, * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 

ERRMSG=ERROR, * 

POOLADR=Tl7770 

L27770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=777 0, * 

DSCNAME=DTF7770, * 

INAREAL=256, * 

BTAMRLN=2, * 

FEATURE=AUTOANSR f * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 

ERRMSG= ERROR 

L37770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770, * 

DSCNAME=DTF7770, * 

INAREAL=2 56, * 

BTAMRLN=3, * 

FEATURE=AUTOANSR, * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 

ERRMSG=ERROR 

L47770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770, * 
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DSCNAME=DTF7770, 

INAREAL=256, 

BTAMRLN=4, 

FEATURE=AUTOANSR, 
ANSWRBK=TERMINAL, 
CONVTAB=ABB , 
RDYMSG=READY, 
ERRMSG= ERROR 

T17770 DFHTCT TYPE=TERMINAL, 
TRMIDNT=7771, 
TRMPRTY=30, 
TRMTYPE=7770, 
TRMSTAT=TRANSCEIVE 
T27770 DFHTCT TYPE=TERMINAL, 
TRMIDNT—7772, 
TRMPRTY=30, 

TRMTYPE=7770, 
TRMSTAT=TRANSCEIVE 
T37770 DFHTCT TYPE=TERMINAL, 
TRMIDNT SS 7 77 3 , 
TRMPRTY=30, 
TRMTYPE=7 770, 
TRMSTAT=TRANSCEIVE 
T47770 DFHTCT TYPE=TERMINAL, 
TRMIDNT=7774, 
TRMPRTY=30, 
TRMTYPE=777 0, 
TRMSTAT^TRANSCEIVE, 
LASTTRM= POOL 
READY DFHTCT TYPE=7770MSG, 

MESSAGE=*001D0B 1 
ERROR DFHTCT TYPE=7770MSG, 

MESSAGE= f 000A0F * 


* 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 


* 

* 

♦ 

♦ 

♦ 

* 

♦ 

♦ 

* 

* 

* 

♦ 

♦ 
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| TELETYPEWRITER EXCHANGE TERMINAL (CPT-TWX) (SWITCHED. USING 
I AUTO-ID AND AUTOPOLL. UNDER CICS/DOS/VS) 


DFHTCT TYPE=SDSCI, * 

CU=2702, * 

DEVICE=TW35, * 

LINELST=(039), * 

SWITCH=YES, * 

DSCNAME=TWXONE 

IDLTWX DFTRMLST IDLST,0,19,01B151FFC393C3CB052BEB1BB151E1E1E1E1A1 

TWXIDA DFTRMLST IDLST,7,4931683,10,500AB222C3052B2B9AB1 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYP E= TWX, * 

DSCNAME=TWXONE, * 

INAREAL=120, * 

BTAMRLN=1, * 

LISTADR=IDLTWX, * 

FEATURE=(AUTOANSR,AUTOCALL), * 

POOLADR= TWXAUTO, * 

ANSWRBK=AUTO 

TWXAUTO DFHTCT TYPE=TERMINAL, * 

TRMIDNT=TWXA, * 

TRMADDR=TWXIDA, * 

TRMPRTY=2 01 , * 

TRMSTAT=TRANSCEIVE, * 

LASTTRM= POOL 
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I TELETYPEWRITER (WTC ONLY) (SWITCHED UNDER CICS/DOS/VS) 


DFHTCT TYPE=SDSCI, * 

DEVICE=TLX , * 

DSCNAME=WTTLX, * 

FEATURE 3 (WRU ), * 

CU=2701, * 

LINELST 3 (051), * 

MONDLY=10, * 

EOM=WRU, * 

EOT=X'371F’ 

FSLST DFTRMLST WTTALST,0,8,FFFFFFFFFFFFFFFF,7,F2F2F6F7F7F0F5 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=TLX, * 

INAREAL= 300, * 

CLASS=HARDCOPY, * 

DSCNAME 3 WTTLX, * 

BTAMRLN=1, * 

LISTADR=FSLST, 

FEATURE 3 AUTOAN SR , 

POOLADR=TERMl, * 

ANSWRBK=AUTOMATIC 

TERM1 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=UHFM , * 

CLASS=HARDCOPY, * 

LASTTRM 3 POOL , * 

TRMADDR=IDLIST 

IDLIST DFHTCT TYPE=TLXID, * 

TLXID 3 '7266521 IBM D* 

DFHTCT TYPE=TLXID, * 

TLXID 3 *8354305 IBM D", * 

LASTID=YES 
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I 2980 GENERAL BANKING TERMINAL SYSTEM (MULTIPOINT UNDER 
I CICS/OS/VS) 


DFHTCT TYPE=SDSCI, * 

DEVICE=BSCMDMPT, * 

BSCODE=EBCDIC, * 

DSCNAME=DTF2980 

TCT29POL DFTRMLST AUTOWLST,(C1C1F02D,37373737) POLL CU 

TCT29PA1 DFTRMLST OPENLST,(8181402D) ADDRESS STATION 1 

TCT29PA2 DFTRMLST OPENLST,(8181F12D) ADDRESS STATION 2 

TCT29PA3 DFTRMLST OPENLST,(8181F22D) ADDRESS STATION 3 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=2 980, * 

DSCNAME=DTF2980, * 

INAREAL=480, * 

BTAMRLN=1, * 

LISTADR = (TCT29POL,WRAP), * 

FEATORE= AUTO POLL 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T801, * 

STN2980=0, * 

TAB2980=04, * 

POLLPOS=01, * 

TRMADDR= TCT2 9 PA1, * 

TRMMODL=l, * 

TRMPRTY=10, * 

TIOAL=200, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T80 2, * 

STN2980=1, * 

TRMADDR=TCT29PA2, * 

TRMMODL=2, * 

TRMPRTY=10, * 

TIOAL=200, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T80 3, * 

STN2980=2, * 

TAB2980=02, * 

TRMADDR= TCT 29PA3, * 

TRMMODL= 4, * 

TRMPRTY=10, * 

TIOAL=200, * 

TRMSTAT=TRANSCEIVE, * 

LASTTRM=LINE 


Note : This is a functional example for CICS/DOS/VS if the 

(C1C1F02D,37373737) parameters in the above TCT29POL DFTRMLST statement 
are changed to 3732,C1C1F02D. 
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3270 INFORMATION DISPLAY SYSTEM (BTAM) (MULTIPOINT UNDER 
CICS/OS/VS) 


POLL77 DFTRMLST AUTOWLST,(40407F7F2D,C1C17F7F2D,3737373737) 

LSTR77A DFTRMLST OPENLST,(606040402D) 

LSTR77B DFTRMLST OPENLST,(616140402D) 

LSTR77C DFTRMLST OPENLST,(6161C1C12D) 

DFHTCT TYPE=SDSCI, * 

DEVICE=BSCMDMPT, * 

DSCNAME=REMOTE77, * 

BSCODE—EBCDIC 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE= 3277, * 

LISTADR=(POLL77,WRAP), * 

BTAMRLN=1, * 

DSCNAME=REMOTE77, * 

INAREAL=256, * 

TRMMODL= 2, * 

FEATURE=AUTO POLL 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R77A, * 

TRMMODL=l, * 

TRMTYPE= 3275, * 

TRMADDR=LSTR77A, * 

POLLPOS=l, * 

COMPAT=(480,12,2260,B), * 

FEATURE=PTRADAPT, * 

CLASS=(CONV,VIDEO,BISYNC), * 

TIOAL=500 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R77B, * 

TRMADDR=LSTR77B, * 

POLLPOS=2, * 

COMPAT=(960,15,2265,D), * 

FEATURE=(COPY,DCKYBD,SELCTPEN) , * 

CLASS=(CONV,VIDEO,BISYNC), * 

TIOAL=1500 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R77C, * 

TRMTYPE= 3286, * 

FEATURE=COPY, * 

CLASS=(VIDEO,BISYNC), * 

TRMADDR=LSTR77C, * 

LASTTRM=LINE, * 

TRMSTAT=TRANSCEIVE, * 

TIOAL=1500 

Note : This is a functional example for CICS/DOS/VS if 

1. the (40407F7F2D, C1C17F7F2D,3737373737) parameters in the above 
POLL77 DFTRMLIST statement are changed to 

3732,40407F7F2D,C1C17F7F2D, and 

2. the LINELST=(029), MODELST=(0), and CU=2703 operands are included 
in the DFHTCT TYPE=SDSCI specification. 
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| 3740 DATA ENTRY SYSTEM (MULTIPOINT UNDER CICS/DOS/VS) 


DFHTCT TYPE=SDSCI, 

DEVICE=3740, 

DSCNAME=MPT3740, 

CU=2703, 

LINELST=(026), 

MODELST=(0), 

FEATURE=(BSC), 

CONFIG=MPT, 

DFHTCT TYPE=LINE, 

AC CMETH= BTAM, 

TRMTYPE=3740, 

INAREAL=600, 

DSCNAME=MPT3740, 

BTAMRLN=1, 

LISTADR=(POLL3740,WRAP), 
FEATURE=AUTOPOLL 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=L374, 

TRMTYPE=3740, 

TIOAL=128, 

TRMADDR=ADDR3 7 41, 
TRMSTAT=TRANSCEIVE, 
FEATURE=TRANSPARENCY, 

BUFFER=128 

POLL3740 DFTRMLST AUTOWLST,3732,ClC12D,C2C22D 
ADDR3740 DFTRMLST OPENLST,(81812D) 

ADDR3741 DFTRMLST OPENLST,(82822D) 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


| 3780 DATA COMMUNICATION TERMINAL (MULTIPOINT UNDER CICS/OS/VS) 


DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DDNAME=DD 3780, * 

DEVICE=3780, * 

DSCNAME=DCB3780 

DFHTCT TYPE=LINE, * 

TRMTYPE=3780, * 

DSCNAME=DCB3780, * 

ACCMETH=BTAM, * 

BTAMRLN=1, * 

BSCODE=EBCDIC, * 

INAREAL= 520, * 

FEATURE 3 AUTOPOLL, * 

LISTADR=(LA3780,WRAP) 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=B37A, * 

LASTTRM=LINE, * 

TIOAL=80, * 

TRMTYPE=3780, * 

BUFFER=512, * 

TRMADDR=TA3780 


LA3780 DFTRMLST AUTOWLST, (C1C1F02D,37373737) 
TA3780 DFTRMLST OPENLST, (81812D) 
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I 3600 FINANCE COMMUNICATION SYSTEM (BSC) (MULTIPOINT UNDER 
| CICS/OS/VS) 


DFHTCT TYPE=SDSCI, * 

DEVICE=3600, * 

DSCNAME=DCB3600, * 

BSCODE=EBCDIC 

TCT36POL DFTRMLST AUTOWLST,(C2C2F02D,C8C8F12D,37373737) 

TCT36PA1 DFTRMLST OPENLST,(8282F72D) STATION ON CUl 

TCT36PA2 DFTRMLST OPENLST,(8282F42D) STATION ON CUl 

TCT36PA3 DFTRMLST OPENLST,(8888F32D) STATION ON CU2 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=3600, * 

LISTADR=(TCT36POL,WRAP), * 

DSCNAME=DSC3600, * 

FEATURE=CAUTOPOLL), * 

INAREAL=400, * 

BTAMRLN=1, * 

CLASS=(BISYNC,CONV) 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=A001, * 

TRMSTAT= CTRANSCEIVE), * 

TRMADDR=TCT36PA1, * 

POLLPOS=01, * 

FEATURE=(TRANSPARENCY), * 

TIOAL=20, * 

BUFFER=100 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=A002, * 

TRMSTAT=(TRANSCEIVE), * 

TRMADDR=TCT36PA2, * 

POLLPOS=02, * 

FEATURE=(TRANSPARENCY), * 

TIOAL=30, * 

BUFFER=100 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=A003, * 

TRMSTAT=(TRANSCEIVE), * 

TRMADDR=TCT36PA3, * 

POLLPOS=03, * 

FEATURE=(TRANSPARENCY), * 

TIOAL=20, * 

BUFFER=100 


Note : This is a functional example of CICS/DOS/VS if: 

1. The (C2C2432D,C8C8662D,37373737) parameters in the above TCT36POL 
DFTRMLST statement are changed to 3732,C2C2F02D,C8C8F12D and 

2. The LINELST=(040), RETRY=6, CU=2703, CONFIG=MPT, and FEATURE=(BSC) 
are added to the DFHTCT TYPE=SDSCI Specification- 
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| 2780 DATA TRANSMISSION TERMINAL (POINT-TO-POINT NON-SWITCHED 
| UNDER CICS/DOS/VS) 

DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DEVICE=27 80 r * 

DSCNAME=DCBN2 780, * 

CU=2703 f * 

LINELST=(023), * 

FEATURE*(BSC,SLV), * 

| MODELST*( 0) , * 

CONFIG*PPT, * 

SWITCH=NO, * 

DFHTCT TYPE=LINE, * 

TRMTYPE=2780, * 

DSCNAME=DCBN2780, * 

ACCMETH=BTAM, * 

BTAMRLN=1, * 

BSCODE=EBCDIC, * 

INAREAL*520 

N2780 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T80A, * 

LASTTRM=LINE, * 

TRMTYPE=2780, * 

TIOAL=100, * 

TRMSTAT=TRANSCEIVE, * 

TRMPRTY=126 

I 2770 DATA COMMUNICATION SYSTEM (SWITCHED UNDER CICS/OS/VS) 

DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DDNAME=DDD2 770, * 

DEVICE=2770, * 

DSCNAME=DCBD2770, * 

MACRF*(R,W), * 

MODE=(,,A,AD, * 

| DFHTCT TYPE=LINE, * 

TRMTYPE*2 770, * 

DSCNAME=DCBD2770, * 

ACCMETH=BTAM, * 

BTAMRLN=1, * 

BSCODE=EBCDIC, * 

POOLADR=D277 0, * 

INAREAL*520, * 

FEATURE*AUTOANSR, * 

LISTADR=LA2 770, * 

AN SWRBK=TERMINAL 

D2770 DFHTCT TYPE*TERMINAL, * 

TRMIDNT=D70A, * 

LASTTRM=POOL, * 

TIOAL=100, * 

TRMTYPE=2770, * 

TRMADDR=TA27 70, * 

TRMSTAT=TRANSCEIVE, * 

TRMPRTY=126 

LA2770 DFTRMLST BSCLST,0,1,2D,2,1070 

TA2770 DFTRMLST BSCLST,0 f 2,1070,1,2D 
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SYSTEM/3 (SWITCHED UNDER CICS/OS/VS) 


DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DDNAME=DDDSYS3, * 

DEVICE=SYS/3, * 

DSCNAME=DCBDSYS3, * 

MACRF=(R,W), * 

DFHTCT TYPE=LINE, * 

TRMTYPE=S YS / 3 , * 

DSCNAME=DCBDSYS3, * 

ACCMETH=BTAM, * 

BTAMRLN=1, * 

BSCODE=EBCDIC, * 

POOLADR=SYS3D, * 

INAREAL=500, 96 X 5 + 20 PAD * 

FEATORE= AUTOAN SR, * 

LISTADR=LASYS3, * 

ANSWRBK=TERMINAL 

SYS3D DFHTCT TYPE=TERMINAL, * 

TRMIDNT=DSY3, * 

LASTTRM=POOL, * 

TIOAL=100, * 

TRMTYPE=SYS/3, * 

TRMADDR=TASYS3, * 

TRMSTAT=TRANSCEIVE, * 

TRMPRTY=126 

LASYS3 DFTRMLST BSCLST,0,1,2D,2,1070 

TASYS3 DFTRMLST BSCLST,0,2,1070,1,2D 
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| 3275 DISPLAY STATION (DIAL/SWITCHED UNDER CICS/DOS/VS) 

DFHTCT TYPE=SDSCI, * 

DEVICE=3275, * 

DSCNAME=DD32 75D, * 

LINELST=(044), * 

CU=2703, * 

FEATURE=(BSC) , * 

MODELST=(0), * 

SWITCH=YES 

DFHTCT TYPE=LINE, * 

AC CMETH= BTAM, * 

TRMTYPE=3275, * 

INAREAL=300, * 

TCTUAL=16, * 

CLASS=(CONV,VIDEO,BISYNC), * 

DSCNAME=DD3 2 75D, * 

TRMMODL=2, * 

BTAMRLN=1, * 

LISTADR=ANS 3 27 5D , * 

| FEATURE=(AUTOANSR,AUTOCALL), * 

AN SWRBR= EXIDVER * 

R75D DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R75D, * 

LASTTRM=POOL, * 

TRMSTAT= TRANSCEIVE, * 

COMPAT=(960,12,2260,1,F2260), * 

FEATURE=(PTRADAPT,SELCTPEN,DCKYBD), * 

TIOAL=1500, * 

TCTUAL=16, * 

PGESTAT=AUTOPAGE 

ANS3275D DFTRMLST SWLST,AN,10,4,2,1070,(86A54C5A2D,0,R75D) 
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3735 PROGRAMMABLE BUFFERED TERMINAL (SWITCHED UNDER 
CICS/OS/VS) 


DFHTCT TYPE=SDSCI, * 

DEVICE=BSCMDSW, * 

BSCODE=EBCDIC f * 

DSCNAME=DTF35D 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE= 3735, * 

DSCNAME=DTF35D, * 

INAREAL=480, * 

BTAMRLN=1, * 

LISTADR=LISTA, * 

FEATURE 3 (AUTOANSR,AUTOCALL), * 

POOLADR=A3735, * 

BSCODE 3 EBCDIC, * 

ANSWRBK=EXIDVER 

A3735 DFHTCT TYPE=TERMINAL, * 

TRMIDNT 3 3735, * 

TRMTYPE 3 37 3 5, * 

LASTTRM 3 POOL, * 

TRMADDR=LISTB, * 

TRMSTAT=TRANSCEIVE, * 

TRANSID=3735, * 

TIOAL=476 

LISTA DFTRMLST SWLST,AN,11,4,2,1070,(98F0F3F5182D,,A3735) 

LISTB DFTRMLST SWLST,AD,4,3374,8,0,1,2D,(98F0F3F5181070,1) 
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| 3740 DATA ENTRY SYSTEM (DIAL/SWITCHED UNDER CICS/DOS/VS) 


DFHTCT TYPE=SDSCI, * 

DEVICE=3740, * 

DSCNAME=DD374lA, * 

BSCODE=EBCDIC, * 

FEATURE 3 (BSC), * 

SWITCH=YES, * 

CU=2703, * 

CONFIG=PPT, * 

LINELST 3 (016), * 

MODELST 3 (0) * 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE 3 3740, * 

DSCNAME=DD3741A, * 

ANSWRBK=EXIDVER, * 

INAREAL=514, * 

BTAMRLN=1, * 

LISTADR=LISTANA, * 

FEATURE 3 (AUTOANSR,AUTOCALL) , * 

POOLADR=TRMA37 41, * 

BSCODE 3 EBCDIC 

TRMA3741 DFHTCT TYPE=TERMINAL, * 

TRMIDNT 3 A3 7 4, * 

TRMTYPE 3 3740, * 

LASTTRM 3 POOL, * 

TRMADDR=LISTADA, * 

TRMSTAT 3 TRAN SCEIVE, * 

TIOAL=128, * 

FEATURE=TRANSPARENCY 


LISTANA DFTRMLST SWLST,AN,10,4,2,1070,(A58189A52D,,TRMA3741) 
LISTADA DFTRMLST SWLST,AD,4,3729,8,0,1,2D,(A58189A51070) 
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I 3740 DATA ENTRY SYSTEM UNDER CICS/OS/VS (POINT-TO-POINT 
J SWITCHED) 


DFHTCT TYPE=SDSCI, * 

DEVICE=BSCMDPPT, * 

DSCNAME=DD3740 

DFHTCT TYPE 3 LINE, * 

ACCMETH-BTAM, * 

TRMTYPE=3740, * 

DSCNAME=DD3740, * 

INAREAL-608, * 

BTAMRLN=1, * 

LISTADR=ANSW3 740, * 

FEATURE 3 (AUTOANSR,AUTOCALL), * 

POOLADR=T3740, * 

ANSWRBK=EXIDVER 
T3740 DFHTCT TYPE=TERMINAL, 

TRMIDNT=3740, * 

TRMTYPE 3 3740, * 

LASTTRM=LINE, * 

TRMSTAT=TRANSCEIVE, * 

FEATURE=TRANSPARENCY, * 

TIOAL=128 , 

BUFFER=128 


ANSW3740 DFTRMLST SWLST,AN,10,4,2,1070,(A58189A52D,,T3740) 
DIAL3740 DFTRMLST SWLST.AD,4,3375,8,0,1,2D,(A58189A51070,1) 


J 2540 CARD READ PUNCH/1403 PRINTER UNDER CICS/DOS/VS 


DFHTCT TYPE=SDSCI, * 

DEVADDR 3 SYSIPT, * 

DEVICE=2540, * 

DS CNAME=READER 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYSLST, * 

DEVICE 3 1403, * 

DSCNAME 3 PRINTER 

DFHTCT TYPE=LlNE, * 

ACCMETH 3 B SAM, * 

TRMTYPE=CRLP, * 

ISADSCN=READER, * 

OSADSCN 3 PRINTER, * 

INAREAL 3 80 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=SAMA, * 

TRMTYPE 3 CRLP, * 

TRMSTAT=TRANSCEIVE 
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| 2314 DIRECT ACCESS STORAGE FACILITY UNDER CICS/DOS/VS 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYS001, * 

DEVICE=2314, * 

DSCNAME=DISKINl 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYS006, * 

DEVICE=2314, * 

DSCNAME=DISKOTl 

DFHTCT TYPE=LINE , * 

ACCMETH=SEQUENTIAL, * 

TRMTYPE*DASD, * 

ISADSCN=DISKIN1, * 

OSADSCN=DISKOTl, * 

INAREAL=80 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=SAMB, * 

TRMPRTY=11, * 

TRMSTAT=(TRANSCEIVEROUT OF SERVICE") 

I PROCESSOR CONSOLE AS A TERMINAL - CICS/DOS/VS ONLY 

DFHTCT TYPE=SDSCI, * 

DEVICE=CONSOLE 

DFHTCT TYPE=LINE, * 

ACCMETH=SEQUENTIAL, * 

INAREAL-80, * 

TRMTYPE= CONSOLE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=CNSL, * 

TRMSTAT=TRANSCEIVE 
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| 3270 INFORMATION DISPLAY SYSTEM (BTAM. LOCAL) UNDER CICS/OS/VS 


DFHTCT TYPE=SDSCI, * 

DEVICE=L3277, * 

DSCNAME=L3270 

DFHTCT TYPE=LINE, * 

AC CMETH= BTAM, * 

DSCNAME=L327 0, * 

TRMMODL=2, * 

TRMTYPE=L3277, * 

POOLADR=T010, * 

INAREAL=2 500, * 

POOLCNT=2 

T010 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L77A, * 

LVUNIT=1, * 

FEATURE= C SELCTPEN,AUDALARM), * 

COMPAT=(480,12,2260,B) 

DFHTCT TYPE=TBRMINAL, * 

TRMIDNT=L77B, * 

LVUNIT=2, * 

TRMTYPE=L3277, * 

LASTTRM= POOL , * 

TRMSTAT=TRANSCEIVE 


Note ; This is a functional example for CICS/DOS/VS if: 

1. the CU=3272 and LINELST=(030,031) operands are included in the 
DFHTCT TYPE=SDSCI specification, 

2. the POOLCNT=2 operand is deleted from the DFHTCT TYPE=LINE 
specification. 
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DFHTCT TYPE=SDSCI, * 

CU=2848, (CICS/DOS/VS only) * 

DEVICE=L2260, * 

LINELST=(021,022,023), * 

FEATURE=KBL , * 

SWITCH=NO, * 

FLNNAME=LINE1, (CICS/OS/VS only) * 

DSCNAME=DFF60L 
LINEl DFHTCT TYPE=LINE, 

| ACCMETH—BTAM, ACCMETH=BGAM for CICS/OS/VS * 

TRMTYPE=L22 60, * 

CLASS=VIDEO, * 

DSCNAME=DTF60L, * 

INAREAL=900 * 

FEATURE=KBRDLOCK 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L60A, * 

LVUNIT=1, * 

TRMPRTY=32, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 


TRMIDNT=L60B, * 

LVUNIT=2, * 

TRMPRTY=32, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L530, * 

TRMTYPE=1053, * 

LVUNIT=3, * 

TRMPRTY=32, * 

TRMSTAT=RECEIVE, * 

LASTTRM= LINE 
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TCAM TERMINAL CONTROL TABLE (CICS/OS/VS ONLY) 


DFHTCT TYPE=INITIAL,SUFFIX=TV 

DFHTCT TYPE=SDSCI, * 

DEVICE=TCAM , * 

DSCNAME=Ll, * 

DDNAME=QINl, * 

OPTCD=WU, * 

MACRF=R, * 

RECFM=U, * 

BLKSIZE=500 

DFHTCT TYPE=SDSCI f * 

DEVICE=TCAM, * 

DSCNAME=L2, * 

DDNAME=QOUTl, * 

OPTCD=WU, * 

MACRF=W, * 

RECFM=U f * 

BLKSIZE=5 00 

DFHTCT TYPE=LINE, * 

ACCMETH=TCAM, * 

QUEUEID=F1, * 

INAREAL=500, * 

TRMTYPE=L2260, * 

DSCNAME=L1, * 

OUTQ=OUTQ 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=DMMY, * 

TRMPRTY=32, * 

LASTTRM= LINE 

OUTQ DFHTCT TYPE=LINE, * 

AC CMETH=TCAM, * 

QUEUEID=F0, * 

INAREAL=500, * 

TRMTYPE=L2260, * 

DSCNAME=L2 

DFHTCT TYPE=TERMINAL , * 

TRMIDNT=TRM1, * 

TRMPRTY=32 

DFHTCT TYPE=TERMINAL , * 

TRMIDNT=TRM2, * 

LASTTRM=LINE, * 

TRMPRTY=32 

DFHTCT TYPE=SDSCI, * 

DEVICE=TCAM, * 

DSCNAME=R70IN, * 

DDNAME=R3270IN, * 

OPTCD=WU, * 

MACRF=R, * 

RECFM=U, * 

BLKSIZE=500 

DFHTCT TYPE=SDSCI f * 

DEVICE=TCAM, * 

DSCNAME=R70OUT, * 

DDNAME=R3270OUT, * 

OPTCD=WU, * 

MACRF=W, * 

RECFM=U, * 

BLKSIZE=500 

DFHTCT TYPE=LINE, * 

ACCMETH=TCAM, * 

INAREAL=500, * 
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DSCNAME=R70IN, * 

OUTQ=OUTQ70, * 

TRMTYPE= 3277 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=DMMX, * 

TRMPRTY=32, * 

LASTTRM=LINE 

OUTQ70 DFHTCT TYPE=LINE , * 

ACCMETH=TCAM, * 

INAREAL=500, * 

DSCNAME=R7 OOUT, * 

TRMTYPE= 3277 

DFHTCT TYPE=TERMINAL, * 

TRMPRTY= 32, * 

TRMIDNT=S70A 

DFHTCT TYPE=TERMINAL f * 

TRMPRTY=32, * 

TRMIDNT=S70B 

DFHTCT TYPE=TERMINAL, * 

TRMPRTY=32, * 

TRMIDNT=S75A, * 

LASTTRM=LINE 

DFHTCT TYPE=FINAL 

END DFHTCTBA 
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3600 FINANCE COMMUNICATION SYSTEM 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=WSl2 f * 

TRMPRTY=50, * 

TRMTYPE=3600, * 

TRMSTAT=TRANSACTION, * 

TIOAL=256, * 

TCTUAL=100, * 

PGESTAT=PAGE , * 

PGESIZE=C6,40), * 

BUFFER=224, * 

LDC=BMSLLDC1, * 

ACCMETH=VTAM, * 

NETNAME=WS12, * 

CONNECT=AUTO, * 

RELREQ=(YES , YES), * 

BRACKET^ YES 


Associated local LDC list: 

BMSLLDCl DFHTCT TYPE=LDCLIST , * 

LDC= (DS, JP, PB=5 , LP, MS) 


System LDC table entry: 

DFHTCT TYPE=LDC, * 

LDC=(DS=1 ), * 

DVC=3604, * 

PGESIZE=(6,40) , * 

PGESTAT=PAGE 


Standard system LDC table: 

DFHTCT TYPE=LDC, * 

LDC-SYSTEM 

Note : See the appropriate CICS/VS subsystem guides for additional 

information regarding LDCs. 
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3614 CONSUMER TRANSACTION FACILITY 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L14A, * 

TRMTYPE= 3614, * 

ACCMETH=VTAM, * 

TRANSID=36CB, * 

TRMSTAT=("OUT OF SERVICE*,TRANSCEIVE ), * 

TRMPRTY=50, * 

TIOAL=256, * 

OPERSEC=14, * 

BRACKET=NO, * 

NETNAME= FC3 614LP, * 

RELREQ=(NO,NO ), * 

CONttECT=AUTO 

3600 PIPELINE LOGICAL UNIT 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=BPT8, * 

TRMTYPE=3600, * 

BMSFEAT=NOROUTE, * 

TRMSTAT=(’OUT OF SERVICE*.TRANSACTION), * 

TIOAL=256, * 

SESTYPE=PIPELNj * 

TRANSID=3606, * 

OPERID=JTWW, * 

OPERPRI=5, * 

OPERSEC=(5,6,7), * 

PIPELN=LAST, * 

BRACKET=NO, * 

TASKNO=l, * 

ACCMETH=VTAM, * 

NETNAME=WS12 , * 

RELREQ=(YES ( NO), * 

BUFFER=32 
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3650 HOST CONVERSATIONAL (3653) LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=HCR1, * 

TRMTYPE= 3650, * 

BMSFEAT=NOROUTE, * 

TRMSTAT=("OUT OF SERVICE",TRANSACTION), * 

TIOAL=256, * 

SESTYPE= 3653, * 

OPERID=JTWW, * 

OPERPRI=5, * 

OPERSEC=(5,6,7), * 

AC CMETH=VTAM , * 

NETNAME=HCD1, * 

CONNECT=AUTO, * 

RELREQ=(YES,NO), * 

BRACKET=YES, * 

BUFFER=240, * 

DUMMY=DUMMY 

3650 PIPELINE LOGICAL UNIT 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=PIP3, * 

TRMTYPE= 3650, * 

BMSFEAT=NOROUTE, * 

TRMSTAT=("OUT OF SERVICE',TRANSACTION) , * 

TIOAL=40, * 

SESTYPE=PIPELN, * 

TRANSID=3653, * 

OPERID=JTW3, * 

OPERPRI=5, * 

OPERSEC=(5,6,7), * 

PIPELN=LAST, * 

TASKNO=4, * 

ACCMETH=VTAM, * 

NETNAME= PIPW, * 

CONNECT=AUTO, * 

RELREQ=C YES,YES), * 

BUFFER=32, * 

BRACKET=NO 
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3650 HOST CONVERSATIONAL (3270) LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=HCD2, * 

TRMTYPE 3 3650, * 

BMSFEAT=OBFMT, * 

TRMSTAT 3 ('OUT OF SERVICE',TRANSACTION), * 

TIOAL=256, * 

SESTYPE=3270, * 

OPERID 3 JTWW, * 

OPERPRI=5, * 

OPERSEC 3 (5,6,7), * 

AC CMETH= VTAM, * 

NETNAME=HCD2, * 

CONNECT=AUTO, * 

RELREQ 3 (YES,YES) , * 

BRACKET=YES, * 

BUFFER=240 


3650 INTERPRETER LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=PROG, * 

TRMTYPE=3 650, * 

BMSFEAT=C NOROUTEALL,FMHPARM), * 

TRMSTAT=C"OUT OF SERVICE',TRANSCEIVE), * 

TIOAL=256, * 

SESTYPE=USERPROG, * 

OPERID 3 PRGl, * 

OPERPRI=5, * 

OPERSEC=(5,6,7), * 

ACCMETH=VTAM, * 

NETNAME 3 PROG, * 

CONNECT=AUTO, * 

RELREQ=(YES,YES), * 

BRACKET=YES, * 

BUFFER=240 


3650 HOST COMMAND PROCESSOR LOGICAL UNIT 


DFHTCT TRMTYPE=TERMINAL, * 

TRMIDNT=HCPA, * 

TRMTYPE= 3650, * 

TRMSTAT=TRANSCEIVE, * 

TIOAL=256, * 

SE STYPE= U SERPROG, * 

ACCMETH=VTAM, * 

NETNAME=QEHCPROC, * 

CONNECT 3 AUTO , * 

RELREQ=NO, * 

BUFFER 3 256, * 

BRACKET=NO 
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3270 INFORMATION DISPLAY SYSTEM (VTAM) 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=xxxx, * 

TRMTYPE=3277, * 

TRMMODL=l, * 

ACCMETH=VTAM, * 

TIOAL=1500, * 

TRMSTAT= ('* OUT OF SERVICE'* ,TRANSACTION) , * 

NETNAME=yyyy, * 

CONNECT=AUTO, * 

RELREQ=(YES,YES), * 

FEATURE=(COPY,DCKYBD,SELCTPEN), * 

PRINTTO=(LABI,COPY), * 

ALTPRT=LAB2 


3270 LARGE SCREEN SUPPORT 


1. BTAM/BSC 3276 Model 3 Display: 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=aaaa, * 

TRMTYPE= 3277, * 

TRMMODL= 2, * 

ACCMETH=BTAM , * 

ALTSCRN=(32,80) 

2. BTAM/Local 3278 Model 1 Display: 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT= bbbb, * 

TRMTYPE=L3277, * 

TRMMODL=l # * 

ACCMETH=BTAM, * 

ALTSCRN=(12,80) 

3. VTAM/SDLC 3278 Model 4 Display: 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=cccc, * 

TRMTYPE=LUTYPE2, * 

TRMMODL=2, * 

ACCMETH=VTAM , * 

ALTSCRN=(43,80) 

4. VTAM/SDLC 3287 Printer: 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=dddd, * 

TRMTYPE=LUTYPE3, * 

TRMMODL= 2, * 

AC CMETH=VTAM, * 

ALTSCRN=(32,80) REQUIRES EXTENDED BUFFER CAPACITY. 


| ALTPGE NEED NOT BE SPECIFIED; WILL 

j DEFAULT TO VALUE IN ALTSCRN 

| 5. VTAM/SDLC 3289 SCS Printer: 
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DFHTCT TYPE=TERMINAL, * 

TRMIDNT=eeee, * 

TRMTYPE=SCSPRT, * 

HF=YES, * 

VF=YES 


Note : For all TCTTEs that have either ALTSCRN or ALTPGE to select the 

alternative screen/page size values, the SCRNSZE=ALTERNATE operand must 
be specified in either DFHPCT TYPE=INITIAL or DFHPCT TYPE=ENTRY. 


3767 COMMUNICATION TERMINAL 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=yyyy, * 

TRMPRTY=60, * 

TRMTYPE= 3767, * 

TRMSTAT=TRANSCEIVE, * 

TIOAL=256, * 

PGESTAT=PAGE, * 

PGESIZE=(12,80), * 

BUFFER-256, * 

BRACKET^YES, * 

ACCMETH=VTAM, * 

NETNAME=XXXXXXXX, * 

CONNECT=AUTO, * 

RELREQ=(YES,YES), * 

VF=YES, * 

HF=YES 


3770 DATA COMMUNICATION SYSTEM (NON PROGRAMMABLE) 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT= zzzz, * 

TRMPRTY=50, * 

TRMTYPE= 3770, * 

TRMSTAT=TRANSCEIVE, * 

CHNASSY=YES, * 

TIOAL=(256,1024), * 

RUSIZE=256, * 

PGESTAT=AUTOPAGE, * 

PGESIZE=(12,80) , * 

BUFFER 25 256, * 

BRACKET-YES, * 

ACCMETH=VTAM, * 

NE TNAME=xxxxxx, * 

CONNECT 25 AUTO, * 

RELREQ=(YES,YES), * 

VF=YES, * 

HF=YES 

DFHTCT TYPE=LDC, * 

LDC=BCHLU 
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3770 BATCH DATA INTERCHANGE LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=LUTl, * 

TRMPRTY=50, * 

TRMTYPE= 3770, * 

SESTYPE=BATCHDI, * 

TRMSTAT=TRANSCEIVE, * 

TIOAL=(256,2048), * 

PGESTAT=AUTOPAGE, * 

RUSIZE=256, * 

BUFFER=256, * 

ACCMETH=VTAM, * 

NETNAME=xxxyyy, * 

RELREQ=YES, * 

CHNASSY=YES, * 

TRANSID=BDSA, * 

HF=YES, * 

VF=YES, * 

LDC=LDCA, * 

BRACKET=YES 


3770 FULL FUNCTION LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, 
TRMIDNT=PCLU, 
TRMTYPE=3 77 0, 
SESTYPE=USERPROG, 
TRMSTAT=TRANSCEIVE, 
TIOAL=256, 

BRACKET=YES, 
ACCMETH=VTAM, 
NETNAME=LU04, 
BUFFER=256 


* 

* 

* 

* 


* 

* 

* 


3790 3270-DISPLAY LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=CCC2, * 

TRMTYPE= 3790, * 

TRMMODL=2, * 

TRMSTAT=TRANSCEIVE, * 

| FEATURE=(SELECTPEN,AUDALARM,UCTRAN,PTRADAPT), * 

TIOAL=(256,1500) , * 

ACCMETH=VTAM, * 

SESTYPE=3277CM, (Screen compatibility) * 

NETNAME=LU9 2, * 

BUFFER=256, 
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3790 FULL FUNCTION LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, 
TRMIDNT=LU95 f 
TRMTYPE= 3790, 
SESTYPE=USERPROG, 
TRMSTAT= TRAN SCEIVE , 
TIOAL=256, 

BRACKET=YES, 
ACCMETH=VTAM, 
NETNAME=LU9 5 , 
BUFFER=256 


* 

* 

♦ 

* 

♦ 

* 

* 

* 

* 


3790 3270-PRINTER LOGICAL UNIT 


DFHTCT TYPE=TERMINAL 
TRMIDNT=CCC5, 
TRMTYPE= 3790, 
TRMMODL= 2 , 
TRMSTAT=TRANSCEIVE 
TIOAL=(256,1500), 
ACCMETH=VTAM , 
SESTYPE=3286CM, 
NETNAME=LU98, 
BUFFER=256 


3790 SCS-PRINTER LOGICAL UNIT 


DFHTCT TYPE-TERMINAL, 
TRMIDNT=CCC6 , 
TRMTYPE= 3790, 
TRMSTAT=TRANSCEIVE 
AC CMETH=VTAM, 
SESTYPE=SCSPRT, 
NETNAME=LU9 9 


* 

* 

* 

* 

* 

* 

* 

(Print Compatibility LU) * 

* 


* 

* 

* 

* 

■ * 

(Print Compatibility LU) * 
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3790 BATCH DATA INTERCHANGE LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=BLU1, * 

TRMPRTY=50, * 

TRMTYPE 3 3790, * 

SESTYPE=BATCHDI, * 

TRMSTAT=TRANSCEIVE, * 

TIOAL=(256,2048), * 

PGESTAT=AUTOPAGE, * 

RUSIZE=256, ♦ 

BUFFER=256, * 

ACCMETH=VTAM, * 

NETNAME=SLU3790, * 

RELREQ=YES, * 

CHNASSY=YES, * 

TRANSID=BD5A, * 

HF=NO, * 

VF=NO , * 

BMSFEAT=OBOPID, * 

LDC=LDCA, * 

BRACKET 3 YES * 


3790 INQUIRY LOGICAL UNIT 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=I1K3, 

TRMTYPE= 3790, 

TRMSTAT=TRANSACTION, * 

ACCMETH 3 VTAM, * 

BUFFER=256, * 

BRACKET 3 YES, * 

RELREQ 3 (YES,NO) 

LDCS FOR 3770 BATCH LOGICAL UNIT 

DFHTCT TYPE=LDC, * 

LDC=XX, * 

DVC=BLUPRT, * 

PGESIZE 3 (12,80), * 

PGESTAT=PAGE 

DFHTCT TYPE=LDC, * 

LDC=YY, * 

DV C= BLUPC H, * 

PGESIZE 3 (1,80), * 

PG ESTAT 3 AUTO PAGE 

DFHTCT TYPE=LDC, * 

LDC=SYSTEM 


I 
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EXTENDED LOCAL LDC LIST FOR 3770 AND 3790 BATCH DATA 
INTERCHANGE LOGICAL UNITS 


IiDCA 


DFHTCT TYPE=LDC,LOCAL-INITIAL 
DFHTCT TYPE=LDC,LDC=BCHLU 
DFHTCT TYPE=LDC, 

LDC=AA, 

DSN=P000004 f 
PGESTAT=AUTOPAGE , 

dvo=bluprt # 

PGESIZE=(30,132) 

DFHTCT TYPE=LDC, 

LDC-BB , 

DSN=P000005, 
PGESTAT=AUTOPAGE , 
DVC=BLUPRT, 

PGESIZE=(30,132) 

DFHTCT TYPE=LDC , 

LDC=CC f 
DSN=P000008, 
PGESTAT=AUTOPAGE, 
DVC=BLUPRT, 

PGESIZE=(1,132) 

DFHTCT TYPE=LDC, 

LDC=DD , 

DVC=BLUPRT, 

PGESIZE=(30,123) 

DFHTCT TYPE=LDC, 

LDC=EE , 

DSN=P00000AA, 
PGESTAT=AUTOPAGE f 
DV 0 s BLUCON , 

PGESIZE 55 (30 ,132) 

DFHTCT TYPE=LDC,LOCAL=FINAL 


* 

♦ 

* 

♦ 

* 

♦ 

* 

4c 

* 

♦ 

♦ 

4c 

4c 

♦ 

4c 

4c 

4c 

4c 

4c 

4c 

4 c 

4c 

4c 


INTERSYSTEM COMMUNICATION 


The first CICS/VS system is defined as follov/s: 


DFHTCT TYPE-INITIAL, 
APPLID=CICSNY, 
ACCMETH=(VTAM) 
SUFFIX=AB 

CICSLA DFHTCT TYPE=ISLINK, 

NETNAME=CICSLA 

SY SIDNT=REM1, 

ACCMETH=VTAM, 

TRMPRTY=100, 

OPERID^OPl, 

OPERSEC=15, 

OPERPRI=50, 

TRMIDNT=LAG1, 

SESTYPE=SEND, 

RUSIZE=512, 

BUFFER=512, 

LASTTRM-VTAM 
DFHTCT TYPE=FINAL 


4c 

4c 

DEFINE INTER * 

-SYSTEM LINK * 

CONTROL INFORMATION * 

4c 

4c 

* 

4c 

4c 

MAINLY A SENDER OF REQUESTS * 
SENDS MAX. OF 512 BYTES * 
RECEIVES MAX. OF 512 BYTES * 
LAST TCTTE ENTRY* 
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The corresponding definition in the second CICS/VS system would be as 
follows: 


DFHTCT TYPE=INITIAL, * 

APPLID=CICSLA, * 

ACCMETH=(VTAM), * 

SUFFIX=AC 

CICSNY DFHTCT TYPE=ISLINK, * 

NETNAME=CICSNY, * 

SYSIDNT=REM1, * 

ACCMETH=VTAM, * 

TRMPRTY=100, * 

OPERID=OPl, * 

OPERSEC=15, * 

OPERPRI=50, * 

TRMIDNT=NYG1, * 

SESTYPE=RECEIVE, MAINLY RECEIVES REQUESTS * 

RUSIZE=512, * 

BUFFER=512, * 

LASTTRM=VTAM 

DFHTCT TYPE=FINAL 

DL/I SHARED DATA BASE SUPPORT CCICS/OS/VS) 

DFHTCT TYPE=INITIAL, * 

ACCMETH=(NONVTAM), NO VTAM TERMINALS * 

or (VTAM), VTAM TERMINALS * 

SUFFIX=AA, * 

APPLID=CICSA, NAME USED FOR CICS/VS * 

IN "CICS" OPTION OF * 

BATCH EXEC PARAMETER * 

IRCBUFSZ=3000 

DFHTCT TYPE=IRCBCH, COMMUNICATION WITH * 

BATCH REGION * 

SESNUMB=3 NO MORE THAN 3 BATCH * 

REGIONS CAN SHARE * 

DL/I DATA BASES WITH * 

CICS/OS/VS AT SAME * 

TIME * 
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1 

Appen 

dix C. Program Generation Summary 

1 

The following are 

the modules generated by the various CICS/VS system 

1 

generation macros 

• 



SYMBOLIC 

SUFFIX 


DFHSG 


NAME 

ABLE 

PROGRAM NAME 

PROGRAM 25 


DFHACP 


Abnormal Condition 

CSO 


DFHAKP 


Activity Key Point 

KPP 


DFHAQP 


Asynchronous Queue Purge 

ATP 


DFHATP 


Asynchronous Transaction Control 

ATP 


DFHBFP 

Yes 

Built-In Function 

BFP 


DFHBFPDY 


Dummy Built-In Function 

CSD 


DFHBMSMM 


BMS Pre-VS Compatibility 

BMS 

1 

DFHCRC 


DL/I Shared Data Base CICS/VSSTAE exit 

ISC* 

1 

DFHCRNP 


Inter-region New Connection module 

ISC* 

1 

DFHCRSP 


Inter-region Control Initialization 


1 



module 

ISC* 


IGG019 


7770 Appendage 

CSO* 


DFHCPY 


VTAM 3270 Print Function Support 

TCP 


DFHCSA 

Yes 

Common Systems Area 

CSA 


DFHCSVC 


Page Fix/Free SVC 

INITIAL* 


DFHCWTO 


Console-write-to-operator(DOS/VS) 

CSO 


DFHDBP 

Yes 

Dynamic Transaction Backout 

DBP 


DFHDCP 

Yes 

Dump Control 

DCP 


DFHDCPDY 


Dummy Dump Control 

CSD 


DFHDCSA 


INITIAL Load 

CSA* 


DFHDIP 

Yes 

Batch Data Interchange program 

DIP 

1 

DFHDRP 


DL/I Shared Data Base Bootstrap program 

ISC* 

1 

DFHDSCTS 


CICS/VS Dummy Sections 

INITIAL 


IGC0021D 


7770 DEB Processor 

CSO* 


DFHDLI 


DL/I Interface 

CSO* 


DFHDLIDY 


Dummy DL/I Interface 

CSO* 


DFHDLQ 


IMS/VS Quasi-Application program 

CSO* 

1 

DFHDRP(A- 

•F) 

DL/I Shared Data Base batch modules 

ISC* 


DFHDSB 

Yes 

Data Stream Builder 

BMS 


DFHDUP 


Dump Utility 

csu 

1 

DFHEAI 


Assembler EXEC link-edit stub 

EXP** 


DFHEAIO 


Assembler EXEC link-edit stub 

EXP** 


DFHEAP 

Yes 

Assembler Command Interface Translator 

EXP 


DFHECI 


COBOL Command Interface Link-edit Stub 

EXP** 


DFHECP 

Yes 

COBOL Command Interface Translator 

EXP 

1 

DFHEEI 


EXEC EIP module 

EIP 

1 

DFHEIP 


Exec Interface program 

EIP 


DFHELR 

Yes 

EXEC Local/Remote module 

ISC 


DFHETC 


EXEC TCP/ZCP module 

EIP 


DFHEFC 


EXEC FCP module 

EIP 

1 

DFHETD 


EXEC TDP module 

EIP 


DFHETS 


EXEC TSP module 

EIP 

1 

DFHESC 


EXEC SCP module 

EIP 


DFHEPC 


EXEC PCP module 

EIP 

1 

DFHEIC 


EXEC ICP module 

EIP 

1 

DFHEKC 


EXEC KCP module 

EIP 

ht 1 

DFHEJC 


EXEC JCP module 

EIP 

f . i 

DFHESP 


EXEC SPP module 

EIP 

i 

DFHEMS 


EXEC BMS module 

EIP 
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SYMBOLIC 

SUFFIX- 


DFHSG 

NAME 

ABLE 

PROGRAM NAME 

PROGRAM= 

| DFHETR 


EXEC TRP module 

EIP 

| DFHEDC 


EXEC DCP module 

EIP 

| DFHEDI 


EXEC DIP module 

EIP 

| DFHEBF 


EXEC BFP module 

EIP 

DFHEPI 


PL/I Command Interface Link-edit Stub 

EXP** 

DFHEPP 

Yes 

PL/I Command Interface Translator 

EXP 

| DFHERI 


RPG II EXEC link-edit stub 

EXP** 

| DFHERP 


RPG II EXEC entry interface stub 

EXP 

DFHEXI 


VTAM 3270 Print Function Support 

TCP 

DFHFCP 

Yes 

File Control 

FCP 

DFHFCPDY 


Dummy File Control 

CSD 

DFHFCD 


File Control ISAM/BDAM module (OS/VS) 

FCP* 

DFHFDP 


Formatted Dump Program 

CSO 

DFHFEP 


F. E. Terminal Test 

CSS 

DFHFIP 

Yes 

FASTER/Compat program 

BMS 

DFHFTAP 


Format Tape program 

KPP 

DFHF2P 

Yes 

Basic Mapping FASTER/Compat 

BMS 

DFHGAP 


Graphics Attention program 

GAP* 

DFHGAPNA 


Graphics Attention Alias 

GAP* 

| DFHGMM 


VTAM good morning message program 

TCP 

DFHHPSVC 


SRB type 6 SVC 

INITIAL* 

DFHICP 

Yes 

Interval Control Program 

ICP 

DFHIIP 

Yes 

Non-3270 Input Mapping 

BMS 

| DFHIRCP 


Inter-region type 2 SVC 

ISC* 

| DFHISP 

Yes 

Intersystem Communication program 

ISC 

DFHJCBSP 


Journal Tasks Bootstrap program 

JCP 

DFHJCC 


Journal Control Close 

JCP 

DFHJCEOV 


Journal Control EOV 

JCP 

DFHJCI 


Journal Control Input 

JCP 

DFHJCIOE 


Journal Control I/O Error program 

JCP 

DFHJCJFP 


Journal Control Format program 

JCP 

DFHJCKOJ 


Journal Control Kickoff program 

JCP 

DFHJCO 


Journal Control Open 

JCP 

DFHJCOCP 


Journal Control Open/Close program 

JCP 

DFHJCP 

Yes 

Journal Control 

JCP 

DFHJCPDY 


Dummy Journal Control 

CSD 

DFHJCSDJ 


Journal Control Shutdown 

JCP 

DFHKCP 

Yes 

Task Control 

KCP 

DFHKCSP 


SRB Service Program 

KCP* 

DFHKPP 

Yes 

Keypoint 

KPP 

DFHKPPDY 


Dummy Keypoint 

CSD 

DFHMCP 

Yes 

Mapping Control 

BMS 

DFHMCPDY 


Dummy Mapping Control 

CSD 

| DFHMIR 


Intersystem Communication mirror module 

ISC 

j DFHMGP 


Error message program 

CSO 

| DFHMGT 


Error message table 

CSO 

DFHMSP 


Message Switching program 

CSO 

DFHMTPA 


Master Terminal program Module A 

MTP 

DFHMTPB 


Master Terminal program Module B 

MTP 

DFHMTPC 


Master Terminal program Module C 

MTP 

DFHMTPD 


Master Terminal program Module D 

MTP 

DFHMTPE 


Master Terminal program Module E 

MTP 

DFHMTPF 


Master Terminal program Module F 

MTP 

DFHMTPG 


Master Terminal program Module G 

MTP 

DFHM32 

Yes 

BMS 3270 Mapping 

BMS 

| DFHLFO 


LIFO storage program 

CSO 

DFHOCP 


Open/Close 

OCP 

DFHPBP 

Yes 

BMS Page Build program 

BMS 

DFHPCP 

Yes 

Program Control 

PCP 

DFHPEP 


Program Error Dummy program 

CSO 
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SYMBOLIC 

SUFFIX- 


DFHSG 

NAME 

ABLE 

PROGRAM NAME 

PROGRAM= 

DFHPHN 


Phonetic Code Conversion (Offline) 

BFP** 

DFHPL1I 


Entry Interface program 

HLL** 

DFHPL10I 


Entry Interface program 

HLL* 

DFHPRK 


VTAM 3270 Print Function Support 

TCP 

DFHPRPR 


HLL Preprocessor 

HLL 

DFHP3270 


3270 Print Function Support 

TCP 

DFHRD1 


ATP Input Processor, Phase 1 

ATP 

DFHRD2 


ATP Input Processor, Phase 2 

ATP 

DFHRKB 


VTAM 3270 Print Function Support 

TCP 

DFHRLR 

Yes 

BMS Route List Resolution 

BMS 

DFHRTY 


CICS/VS-supplied transaction restart 
module 

DBP 

DFHRUP 


Recovery Utility program 

KPP 

DFHRWP70 


7770 Read/Write 

CSO* 

DFHSAP 


PL/I Interface 

HLL 

DFHSCP 

Yes 

Storage Control 

SCP 

DFHSCR 

Yes 

Storage Control Recovery 

SCP 

DFHSDAM 


Direct Access Logic Module (DOS/VS) 

CSO 

DFHSFP 


Sign-Off 

CSS 

DFHSIA1 


System Initialization - Module A1 

CSO 

DFHSIBl 


System Initialization - Module B1 

CSO 

DFHSICl 


System Initialization - Module Cl 

CSO 

DFHSID1 


System Initialization - Module Dl 

CSO 

DFHSIEl 


System Initialization - Module El 

CSO 

DFHSIF1 


System Initialization - Module Fl 

CSO 

DFHSIGl 


System Initialization - Module G1 

CSO 

DFHSIH1 


System Initialization - Module HI 

CSO 

DFHSII1 


System Initialization - Module 11 

CSO 

DFHSIJ1 


System Initialization - Module J1 

CSO 

DFHSIP 


System Initialization 

CSO 

DFHSNP 


Sign-On 

CSS 

DFHSPP 


Sync Point program 

KCP 

DFHSRP 

Yes 

System Recovery 

SRP 

DFHSRPDY 


Dummy System Recovery 

CSD 

DFHSTLK 


ISC Link statistics program 

CSO 

DFHSTKC 


Supervisor Statistics 

CSO 

DFHSTP 


System Termination 

CSO 

DFHSTPD 


Program and Dump Statistics 

CSO 

DFHSTSP 


Auto. Statistics Summarization Control 

CSO 

DFHSTTD 


Data Management Statistics 

CSO 

DFHSTTR 


File and Terminal Statistics 

CSO 

DFHSTUP 


Auto. Statistics Summarization Utility 

csu 

DFHTACP 


Terminal Abnormal Condition 

CSO 

DFHTAJP 


Time of Day Adjustment 

CSO 

DFHTBP 


Transaction Backout program 

TBP 

DFHTCP 

Yes 

Terminal Control 

TCP 

DFHZHPRX 


RPL Executor in SRB Mode 

TCP* 

DFHTDP 

Yes 

Transient Data 

TDP 

DFHTDPDY 


Dummy Transient Data 

CSD 

DFHTDRP 


Transient Data Recovery program 

KPP 

DFHTEOF 


Tape End of File program 

KPP 

DFHTEP 


Terminal Error Dummy program 

CSO 

DFHTPP 

Yes 

BMS Terminal Page program 

BMS 

DFHTPQ 


BMS Terminal Page Clean-up 

BMS 

DFHTPR 


BMS Terminal Page Retrieval 

BMS 

DFHTPS 


BMS Delayed Message Delivery 

BMS 

DFHTRP 

Yes 

Auxiliary Trace program 

TRP 

DFHTRPDY 


Dummy Trace Control 

CSD 

DFHTSP 

Yes 

Temporary Storage 

TSP 

DFHTSPDY 


Dummy Temporary Storage 

CSD 
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SYMBOLIC 

SUFFIX- 

DFHSG 

NAME 

ABLE PROGRAM NAME 

PROGRAM^ 


DFHTSRP 


Temporary Storage Recovery program 

KPP 

DFHTUP 


Trace Utility program 

CSU 

DFHWT1 


ATP Output Processor, Phase 1 

ATP 

DFHWT2 


ATP Output Processor, Phase 2 

ATP 

DFHXFP 

Yes 

ISC Transformer program 

ISC 

DFHXFQ 


DL/I Shared Data Base Transformer program ISC* 

DFHZCA 


VTAM Terminal Control program module 

TCP 

DFHZCB 

Yes 

VTAM Terminal Control program module 

TCP 

DFHZCP 

Yes 

Common Terminal Control program module 

TCP 

DFHZCX 

Yes 

Common Terminal Control program module 

TCP 

DFHZCY 


VTAM Terminal Control program module 

TCP 

DFHZCZ 

Yes 

VTAM Terminal Control program module 

TCP 

DFHZNAC 


Node Abnormal Condition program 

RSP 

DFHZNEP 


Node Error program interface program 

RSP 

DFHZRLG 


Response Logging program 

RSP 

DFHZRSP 


Resend program 

RSP 

PLISHRE 


PL/I shared library transfer vector 

HLL 


* CICS/OS/VS Only 

** Separately generated for DOS/VS, Refer to the CICS/VS System 
Programmers Guide (DOS/VS) . 
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Appendix D. Cross-Reference Table 


This appendix provides the system programmer with a quick cross- 
reference facility to check that related macros and operands have been 
specified in his CICS/VS system. The macros are given in alphabetic 
order as they appear in Parts 2 and 3. 


Location _ Macro/Ooerand Specified 

* DFHSG TYPE=INITIAL CICSSVC=number 

\ 


DEBCHK=YES 


EJECT=YES 


VSAM=NO 

VTAM=NO 


Related Macro/Operand 

When DFHPCT TYPE=ENTRY 
includes ANTICPG=nn or 
YES,or DFHPPT TYPB=ENTRY 
includes RES=FIX, or 
DFHNLT TYPE=ENTRY 
includes FIX=YES. 

When OPSYS-VSl is 
specified in DFHSG 
TYPE=INITIAL<7770 only.) 

Has no effect if 
PRINT=NOLIST is 
specified in DFHSG 
TYPE=INITIAL. 

Must be specified if the 
host system does not 
include VSAM or VTAM. 


SRBSVC=number 


* DFHSG PROGRAM=BMS PAGING=YES 

and 

ROUTING=YES 

BMSPB=YES 
or default 


For MVS only. Is 
required to use 
the high performance 
option (HPO). 

DFHSG PROGRAM=TSP 
must be generated. 


Requires BMSPGO=YES 
or default. 


BMSTXB=YES Requires BMSPGO=YES 

or default or default 


BMSCPY=YES Requires: 

PAGING=YES, 

ROUTING=YES, 
BMSTXB=YES or default, 
BMSPGO=YES or default. 

BMSRCVR=YES Requires PAGING=YES. 

BMSTAB=YES Requires MAPHC=YES. 


BMSFMP=YES 


For logical units 
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Location 


♦ DFHSG PROGRAM 22 CSO 


* DFHSG PROGRAM 22 DIP 


* DFHSG PROGRAM 22 EXP 


Macro/Operand Specified 


COMPAT=F2260 


COMPAT=PRE-VS 

BMSOBF=3270 

PAGING=YES/ 
ROUTING 22 YES 

PRGDLAY=hhmm 


BMSDEV=BCHLU 
or 3770B 

ROUTING=YES 

BMSDEV=3650 or 3270 

SVC=number 


DFHSG PROG=DIP 

DFHSG PROGRAM 22 EXP 


Related Macro/Operand 


which have BMSFEAT 
-FMHPARM specified 
in their TCTTE. 

Requires: 

PAGING 22 YES, 

MAP3276=YES, 

MAPHOYES, 

BMSMBD=YES, 

BMSPB=YES and 
BMSPGO=YES to be 
specified in this macro. 

Requires MAP3270=YES in 
this macro. 

Requires MAP3270=YES in 
this macro. 

Requires AUTOTRN=YES in 
DFHSG PROGRAM=TCP. 

Requires: 

PAGING 22 YES, 

ROUTING 22 YES, 

BMSPRG=YES or default, 
BMSTXB=YES or default, 
and BMSPGO—YES or 
default in this macro. 

DFHSG PROGRAM=DIP 
must be generated. 

Requires PAGING 22 YES and 
BMSPGO=YES or default. 

Requires MAP3270=YES 
or default. 

Required if DFHSG 
PROGRAM 22 TCP includes 
ACCMETH=BTAM and 
BTAMDEV 22 7770, and if 
DFHTCT TYPE=SDCSI 
includes APPENDG=xx.. 

Must be specified if 
BMSDEV in DFHSG 
PROGRAM 22 BMS has BCHLU 
or 3770B. 

In DOS/VS, in order to 
run the link edit job 
produced by this 
program, the private 
relocatable library 
supplied on the 
distribution volume 
must be installed and 
assigned. In OS/VS, 
the starter system 
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Location 


Macro/Operand Spec ified Related Macro/Operand 


* DFHSG PROGRAM= FCP FILSERV=LOCATE 


AUTOJRN= YES 

* DFHSG PROGRAM=JCP AUTOJRN=YES 

DTB=AUX or MAIN 

| * DFHSG PROGRAM=KCP OPSECUR=YES 

I 

* DFHSG PROGRAM=POP HLLTR= 

COBOL= 

* DFHSG PROGRAM=TBP DFHSG PROG=TBP 

* DFHSG PROGRAM=TCP ACCMETH=VTAM 

ACCMETH=SAM 
or BSAM 

ACCMETH=BTAM 

ACCMETH=VTAM 

ANSWRBK* 


library must be 
available. 

Is required when DL/I is 
to be supported; when 
AUTOJRN 3 YES appears in 
DFHSG PROGRAM=FCP; when 
data base backout is to 
be provided for files 
specified in DFHFCT TYPE 
=DATASET With I*OG=YES. 
DFHSG PROGRAM=OCP must 
also be generated* 

Required if recovery/ 
restart is desired from 
DFHSG PROGRAM=TDP• 

Must be specified for 
recovery/restart support* 
Must be the same as the 
option specified in the 
AUTOJRN operand of DFHSG 
PROGRAM=FCP• 

DFHSG PROGRAM=TSP must 
be generated. 

Requires DFHSG PROGRAM 3 
CSS to be generated. 

Requires the LANG 3 
operand in the same 
macro. 

Requires LANG=COBOL in 
the same macro. 

Must be generated if AKP 
3 YES is specified in 
DFHSG PROGRAM 3 KPP• 

DFHSG PROGRAM=RSP must 
be generated. 

DEVICE 3 must be 
specified in the same 
macro. 

BTAMDEV 3 must be 
specified in the same 
macro. 

VTAMDEV 3 must be 
specified in the same 
macro. 

Must be specified if 
FEATURE 3 AUTOANSW is 
specified in the same 
macro. The features 
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Location __Macro/Qperand Specified_Related,,l* 3 cro/Qp.gjE 3 nd 


specified in this macro 
must also be specified 
in the ANSWRBK operand 
Of DFHTCT TYPE=LlNE. 

Must be specified if: 
ROUTING*YES or 
PAGING=YES in DFHSG 
PROGRAM*BMS, 

DFHSG PROGRAM*ATP is 
generated, 

DFHSG PROGRAM=TDP 
includes INTRA=TRANSINIT, 
and DFHDCT TYPE=INTRA 
includes TRANSID. 

ANSWBK=EXIDVER must be 
specified in this macro. 

FMT2260 or FMT3270 must 
be specified in this 
macro. 

FEATURE*KBRDLOCK must be 
specified in DFHTCT TYPE 
LINE. 

Must be specified when 
FEATURE=UCTRAN is 
included in DFHTCT TYPE 
=TERMINAL. 

VTAMDEV*3770B DFHSG PROGRAM=DIP 

or BCHLU with must be generated. 

BMS features 

♦ DFHSG PROGRAM=TDP DESTRCV*YES DFHSG PROGRAM=KPP must 

include AKP=YES. 

DFHSG PROGRAM*JCP must 
include AUTOJRN*YES. 

Note: The macros and operands required for recovery/restart support are 
| listed in in full in Chapter 2.3 under "Generating Recovery/Restart 
j Support". 

* DFHDCT TYPE=INTRA DESTID* 


♦ DFHDCT TYPE=SDSCI DSCNAME* 


* DFHFCT TYPE=DATASET SERVREQ* 


SERVREQ* 


Must be the same as that 
specified in DFHTCT TYPE 
*TERMINAL,TRMIDNT* (for 
terminal destinations.) 

Must be the same as 
that specified in DFHDCT 
TYPE*EXTRA. 

When the SEGMENT option 
is specified, DFHFCT 
TYPE*SEGDEF, SEGHEAD, 
SEGSET and SEGLAST macros 
must be generated. 

If BROWSE is specified 


AUTOTRN=YES 


BTAMDEV*3735D 
or 3275D 

COMPAT=FORMAT 
and/or FULLBUF 


INITRL=YES 

LOCKF=YES 


UCTRAN* 
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Location 


Macro/Operand Specified 


Related Macro/Operand 


DFHFCT TYPE=LOGICMOD 
must be generated 
(DOS/VS only.) 

SERVREQ= When MODE=MIXED is 

specified in this macro 
only the GET, PUT and 
UPDATE options are valid. 

SERVREQ=SHARE A DFHFCT TYPE=SHRCTL 

macro must be generated 
for DL/I data bases 
under VSAM. 

MODE=MIXED A DFHFCT TYPE=ALTERNATE 

macro must be generated 
(MVS only) 


STRNO= 


Must be specified when 
ACCMETH=VSAM. 


* DFHFCT TYPE=INDACC TYPE=INDACC 


* DFHNLT TYPE=ENTRY FIX=YES 


PAGIN= 


* DFHPCT TYPE=ENTRY ANTICPG= 

nn or YES 

XTRANID=hex id 
+ TASKREQ and/or 
TRANSID 


If this is required, 
SERVREQ in DFHFCT TYPE= 
DATASET must include the 
GET and INDACC options. 

Requires CICSSVC=number 
in DFHSG TYPE=INITIAL. 

Must not be specified 
when ADRSPCE=HIGH is 
specified in this macro. 

Require CICSSVC=number 
in DFHSG TYPE=INITIAL. 

Requires INDEX=YES 
in DFHPCT TYPE= 

INITIAL. 


DFHPCT TYPE=OPTGRP MSGPOPT=(PROTECT,...) Overrides the TIOTYPE= 

or MSGPREQ=(PROTECT,...) IMMED specification in 

DFHPCT TYPE=ENTRY• 


* DFHPPT TYPE=ENTRY RELOAD=YES 


* DFHSIT 


APPLID= 


Must be specified if the 
dynamic open/close 
function (DFHOG) is to 
be used for DOS/VS 
transient logic modules. 

Must be specified if the 
APPLID operand is not 
specified in DFHTCT TYPE 
=INITIAL, also for 
logical units, or when 
the DL/I inter-region 
controller is being used. 


PGCHAIN= 

PGCOPY= 


Required if PAGING=YES 
is specified in DFHSG 
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Location 


Macro/Ope rand Specified_R ^^t e d ..MAc ro/Qp ex^n,d 


PGPURGE= PROGRAM=BMS• 

PGRET= 

SVD=YES or nn 


* DFHTCT TYPE=IRCBCH TYPE=IRCBCH 


• DFHSG PROGRAM=ISC, 
IRCSVC=n 

• DFHSG PROGRAM-TCP , 
ACCMETH=IRC 

• DFHTCT TYPE=INITIAL, 
APPLID=name,IRBUFSZ 
=n. 

• Remote PSBs defined 
in DFHDLPSB TYPE= 
ENTRY. 


RECOVERIES in DFHSG 
PROGRAM= SCP and FDP= 

SNAP or FORMAT in DFHSIT 
must be specified. 

Must be specified if a 
DL/I shared data base/ 
inter-region communis 
cation session is to 
take place. 

Requires: 


♦ DFHTCT TYPE=ISLINK TYPE=ISLINK Must be generated if an 

intersystem communication 
session is to be est¬ 
ablished. Requires the 
following: 

• DFHSG PROGRAM=ISC 

• DFHSG PROGRAM=TCP , 
ACCMETH=VTAM, VTAMDEV= 
LUTYPE6 

• An entry for the 
"mirror" transaction 
(CSMI) in the PCT or 
from DFHPT TYPE=GROUP 
,FN=ISC 

• An entry for DFHMIR 
(the mirror program) in 
the PPT or from DFHPPT 
TYPE=GROUP,FN=ISC. 

• Remote resources 
(if any) defined in 
the TYPE=REMOTE 
macros of the DCT f 
FCT f and/or TST # 
unless the application 
program has the SYSIDNT 
parameter in the 
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Location 


Macro/Operand Specified 


Related Macro/Operand 


| command level 

| statement. 


* DFHTCT TYPE=LINE ANSWRBK= 


FEATURE^ 

AUTOPOLL 


ANSWRBK= 

POOLADR= 


* DFHTCT TYPE=SDSCI DSCNAME= 


LERBADR= 

* DFHTCT TYPE=TERMINAL TRMIDNT= 

FEATURE= 

UCTRAN 

TRMTYPE= 


The corresponding options 
must also be specified 
in the ANSWRBK operand 
Of DFHSG PROGRAM=TCP. 

FEATURE 25 SCONTROL must 
also be specified for 
2740. 

FEATURE=AUTOANSR must 
be specified for both 
these operands. 

The name specified must 
be the same as that in 
ISADSCN and OSADSCN in 
DFHTCT TYPE=LINE for 
sequential data sets. 

For BTAM data sets, 
DSCNAME must be the same 
as that in DSCNAME in 
DFHTCT TYPE=LINE. 

Is only required when 
ERROPT=C is specified in 
this macro. 

Must be the same as in 
DESTID in DFHDCT TYPE= 
INTRA for terminal 
destinations. 

UCTRAN= must be 
specified in DFHSG 
PROGRAM=TCP. 

Specifies the terminal 
types 

a) If not already 
specified in DFHTCT TYPE 
LINE 

b) To override the above 
specification. 


| The following table provides information on how to specify, through 
| the TRMTYPE and SESTYPE operands of DFHTCT TYPE=TERMINAL, some of the 
| possible configurations for 3270 devices, some of which may be used to 
| provide alternative screen size support. TRMTYPE and SESTYPE 
| specifications are given for local, BSC, and SDLC connections. 


I 
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Devices 

| Connection 

i 

TRMTYPE= 

| SESTYPE= 

3274+3278 

| BSC 

| Local/SDLC 

i 

(SNA) | 

• 

3277 

LUTYPE2 

i 

i 

3276 

| BSC 

| SDLC (SNA) 

I 

1 

1 

1 

3277 

LUTYPE2 

i 

i 

■ 

3276+3278 

| BSC 

| SDLC (SNA) 

1 

1 

1 

1 

3277 

LUTYPE2 

1 

a 

3274+3277 
(no large 
screen support) 

| BSC 

1 Local/SDLC 

1 

1 

1 

(SNA) | 

I 

3277 

LUTYPE2 

1 

1 

3274+3284 or 
3286 (3288) 

(no large 
screen support) 

| BSC 

| Local/SDLC 

I 

1 

1 

(SNA)| 

1 

1 

1 

3284 or 3286| - 

LUTYPE3 | - 

1 

1 

3274+3287 or 
3289 

| BSC 

1 

1 

1 

1 

3284 or 3286| - 


3274+3284/3286 

3274+3287/3289 

3276+3287/3289 

3276+3287/3289 


3790+3276, 
3277, or 3278 
(no large 
screen support) 

3790+3287/3289 
(no large 
screen support) 


3790+3276 

+3287/3289 


3790 + SCS 
printer (for 
example, 3287) 


Local/SDLC (SNA) 
Local/SDLC (SNA) 
Local/SDLC (SNA) 
Local/SDLC (SNA) 


BSC 

SDLC (SNA) 


Local/SDLC (SNA) 


Local/SDLC (SNA) 


Local/SDLC (SNA) 


Local/SDLC (SNA) 


LUTYPE3 

SCSPRT 

SCSPRT 

SCSPRT 


3284 or 3286 
LUTYPE3 


3790 

LUTYPE2 


3790 

LUTYPE3 


3790 

LUTYPE3 


3790 

SCSPRT 


3277CM 


3284CM/ 
3286CM 


3286CM 


SCSPRT 
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Appendix E. Error Messages and Codes 


The following appendix contains a list of error messages generated in 
| DFHTACP for terminal error programs, and in DFHNACP for node error 
programs, with the corresponding error codes. 


| TERMINAL ERROR PROGRAM 

The following error messages, error codes, and default actions relate to 
abnormal conditions detected from BTAM and TCAM supported terminals. The 
code containing the error condition is passed to DFHTEP in a one-byte 
field of the TACLE called TCTLEPFL. Control is then passed to the 
appropriate TEP for resolution of the error. 

Before giving control to DFHTEP, DFHTACP establishes certain default 
actions to be taken, depending upon the particular error condition that 
has been detected. The default actions are indicated by appropriate bit 
settings in the one-byte field of the TACLE labeled TCTLEECB+1 or 
TCTLEECB+2. The default actions and their appropriate settings are 
given at the end of this section. 


Error Error Code 

Message (Value) Condition 


Action Set 
By DFHTACP 
(See Notes) 


DFH2501 X* 81* (TCEMCMTL) 


| DFH2503 X"83* (TCEMCAAR) 

DFH2502 X"84 * (TCEMCTCT) 


Input message exceeds read length, 
or lost data signalled 
on read text for remote device 


(follows unit check error). 3 

2740-2 auto output request. none 

TCT search error. 

• Switched line - Real 3 

terminal 

• Switched line - Dummy none 

terminal 

• Nonswitched line - Real 2,3 

terminal 

• Nonswitched line - Dummy 1 

terminal 


DFH2511 X"85" (TCEMCROT) Invalid write request. 

• A write request was made to 3 

a terminal in INPUT status. 

• A write request was made to 3 

a 3735 before EOT (EOF 
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Error 

Message 

Error Code 
(Value) 

Action Set 

Condition Bv DFHTACP 




(See Notes) 




condition) was received from 
the 3735 during batch 
transmission. 


DFH2505 

X 1 ' 86 * (TCEMCPL) 

Polling list error. 

1 

DFH2529 

X'87" (TCEMCUI) 

Unsolicited input. 




• 

Input has occurred on an 
out-of-service terminal 
(3735). 

none 



• 

Terminal "Receive Only" 

(TCAM) (TCTLEECB+ 3 = X’03"). 

6 



• 

Terminal "Out of Service" 

(TCAM) (TCTLEECB+3 = X’04'). 

2,6 



• 

Task has not issued a read 
(TCAM) (TCTLEECB+3 = X*01’). 

none 



• 

No available TCTTE from the 
pool (TCAM) (TCTLEECB+3 = X ,, 02' 

none 

). 

DFH2507 

X" 88'* (TCEMCIER) 

BTAM return code on read. 




• 

Local 3270 open failure 
invalid RLN, unreliable 
information (DOS/VS ), 
device under OLTEP 

2,3 



• 

Local 2260 

2,3 



• 

All other conditions 

1,3 


X'89* (TCEMCSM) 

Error status received from remote 
BSC device. 


DFH2526 


• 

3270 intervention required 
(printer) 

none 

DFH2527 


• 

3270 intervention required 
(screen) 

none 

DFH2528 


• 

3735 (all conditions) 

none 

DFH2528 


• 

Operation check (other devices) 

3 

DFH2528 


• 

All other conditions/devices 

2,3 

DFH2510 

X"8A" (TCEMCTO) 

7770 32-second timeout. 

3,5 

DFH2512 

X"8B'' (TCEMCOBE) 

Hardware buffer exceeded (shift 
character not properly accounted 
for). 

3 

DFH2506 

X * 8C (TCEMCOER) 

BTAM return code on write. 




• 

Local 3270 open failure. 

2,3 
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Error Error Code Action Set 

Message (Value) Condition Bv DFHTACP 

(See Notes) 


Invalid RLN, unreliable 
information (DOS/VS), 
device under OLTEP 





• Local 2260 

2,3 




• All other conditions 

1.3 

DFH2513 

X' 8D" 

(TCEMCOLZ) 

Output length zero* 

3 

DFH2514 

X"8E" 

(TCEMCNOA) 

No output area provided. 

3 

DFH2515 

X"8F" 

(TCBMCOAE) 

Output area exceeded (TIOATDL 
value larger than output area). 

3 

DFH2531 

X*91* 

( ) 

IC error on unavailable printer 

entry 




(refer to 3270 Unavailable Printer” in 




Chapter 4.2. 

none 

DFH2516 

X" 94'* 

(TCEMCUC) 

Unit check (actions same as TCEMCUCS). 

DFH2517 

X" 95" 

(TCEMCUCS) 

Unit check (should not occur). 



• L2260, L3270, or SAM 

1. SAM Line 1,3 

2. L2260 or L3270 operation 

check only 3 

3. L2260 or L3270 other sense 

(including L3270 undetermined 
unit error) 2,3 

• Remote lines 

• Switched line disabled 4 

(CICS/OS/VS). 

• Intervention sense 

1. Switched line 3,4 

2. Non-switched, real terminal 2,3 

3. Nonswitched, dummy terminal 1 

• Lost data on read text 3 

(message DFH2501 also issued, 

see code X*81') 

• Data check sense 

1. Real terminal 2,3 

2. Dummy terminal 1 

• Timeout sense 

1. READ or WRITE TEXT command 

on start/stop device none 

2. other timeout, real terminal 2,3 

3. Other timeout, dummy terminal 1 

• All other sense 1 


DFH2518 X'96" (TCEMCUE) Unit exception (actions same as 

(TCEMCUES). 
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Error 

Message 

Error code 
(Value) 

Condition 

Action Set 
Bv DFHTACP 





(See 

Notes) 

DFH2519 

X"97 * (TCEMCUES) 

Unit exception (should not occur). 




• 

Switched line 


3,4 



• 

Real terminal 


2,3 



• 

Dummy terminal 


1 

DFH2520 

X"98" (TCEMCNR) 

Negative re s pons e. 





• 

Negative response to 

addressing 

2,3 



• 

Negative response to 
AUTO OUTPUT" message 

"DFH2503 

none 

DFH2521 

X * 99* (TCEMCUDT) 

Undetermined unit error. 





• 

Local 2260 


2,3 



• 

Local 3270 (see code 

X"94") 




• 

All other devices 


1,3 


DFH2523 X"9B" (TCEMCICR) The terminal entries on the "to" 3 

and "from* device did not specify 
the COPY feature (3270). 


The device address specified for 
the "to" device does not exist 
on the control unit. 

The length of the COPY command 
was not specified as one. 

DFH2524 X™9C" (TCEMCIMB) Invalid message block received. 

• An unidentified message block 
was received from a local 
or remote 3270. 

• The type of input block 
received from a 3735 did not 
agree with the mode of the 
active transaction inquiry 
batch. 

DFH2525 X'9D" (TCEMCICM) An incomplete message was received 2,3 

from a remote 3270. The device 
terminated transmission prior to 
message completion (that is, EOT 
received prior to ETX). 

DFH2508 X'9E" (TCEMCUP) A 3270 print request was made but none 

no printer was available to print 
the data. DFH2531 or DFH2532 may 
subsequently appear - see code X" 91* 
and "3270 Unavailable Printer" in 
Chapter 4.2. 
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Error 

Message 

Error Code 
(Value) 

Condition 


Action Set 
Bv DFHTACP 

DFH2534 

X" 9F" (TCEMIDR) 

TCAM has issued an 

invalid 

(See Notes) 

3 



destination return 

code to 

CICS/VS. 


DFH2530 X’AO* (TCEMCWOT) Invalid read request: 

• A read request was issued to 3 

a terminal in RECEIVE status. 


• A read was issued to a 3735 3 

terminal after an EOT 
(EOF condition) was received 
from the terminal during batch 
transmission. 

DFH2509 X'Al" (TCEMCIDR) A transaction has requested a 5 

DFHTC TYPE=(RESET,DISCONNECT) 
on a switched binary synchronous 
line and no EOT has been received 
from the terminal; this indicates 
more data is to follow. Terminal 
control issues a read to the 
terminal. If the EOT is not 
received on that read, the error 
code is set and passed to DFHTACP. 

Notes: 


Default 

Action Description Bit Setting Mask 

1 Line out of service X'80* at TCTLEECB+1 

2 Terminal out of service X*08* at TCTLEECB+1 

3 - ABEND transaction X*04* at TCTLEECB+1 

4 - Switched line disabled X*20* at TCTLEECB+1 

5 - Disconnect switched line X*10* at TCTLEECB+1 

6 - Release TCAM incoming message X"80" at TCTLEECB+2 


| NODE ERROR PROGRAM 


The following error messages, error codes and action flag settings 
relate to abnormal conditions detected during sessions involving VTAM- 
supported logical units. The code containing the particular error 
condition detected is passed to DFHZNAC in a one-byte field of the 
TWAEC. DFHZNAC then passes control to the appropriate node error 
program for resolution of the error. 

The action flags set are described in full detail in "Logical Unit 
I/O Error Handling (DFHZNAC/DFHZNEP)* in Chapter 5.2 of this manual. 


Error 

Error Code 


Action 

Messaae 

(Symbolic Label) 

Condition 

Flags 

DFH2400 

X** * (TCZSRCAT) 

Error not supported. 

X* 60E003" 

Appendix 

E. Error Messages 

and Codes 
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Error 

Message 


DFH2401 


DFH2402 


DFH2403 


DFH2404 


Error Code 

(Symbolic Label) Condition 


Action 

Flags 


• An unanticipated error 
code was passed to 
CICS/VS by VTAM. 

The SYNAD exit was un¬ 
able to identify the 
error received from 
VTAM. 

X*Bl* (TCZRPLAC) RPL active. X*60E003* 

• A logic error has 
occurred such that a VTAM 
request is being set up 
using an RPL which 
already has an active 
request. 

• The VTAM CHECK macro in¬ 
struction was not issued 
by the appropriate exit. 


* Code is vari- • 

able; taken from 
TCTEVRC5. 


X*B3 * (TCZN0RPL) No RPL available when one X*200000* 

was expected. 

• The RPL pointer field in 
the TCTTE (TCTERPLA) was 
inadvertantly cleared. 

• A logic error has 
occurred within CICS/VS 
which caused the RPL to 
be freed. 

X*ll* (TCZSRCBF) Session bind failure. X*400003* 

• A session cannot be 
established because no 
physical path can be 
found to the logical 
unit. 

• Logical unit does not 
exist. 

• Logical unit does not 
agree with the BIND 
parameters. Possible 
system generation 
mismatch. For an 
intersystem communication 
session, refer to the 
section on sense codes 
sent by CICS/VS. 

X*14* (TCZLRCER) VTAM detected a logic error X*60E003* 

with request. 

• VTAM request was either 
not complete or not 
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Condition 


Action 

Flags 


Error Error Code 

Message (Symbolic Label) 


executable. 

• Conflicting parameters 
in the RPL. 


DFH2405 

X'lO* 

CTCZSRCTU) 

Node not activated. 

The node either was not 
activated or was deactivated 
by the network operator. 

X"000002* 

DFH2406 

X'19 f 

(TCZSRCTS) 

Terminate-self command 
received. 

The logical unit has 
requested to be disconnected. 

X'OOEOOl* 

DFH2407 

X'15" 

(TCZSRCPF) 

Permanent failure with 
channel or NCP/VS. 

X*60E001* 




• Either the NCP/VS has 

abnormally terminated or 
was shut down by the 
operator. 





• A channel failure has 

occurred. 


DFH2408 

X" 1A' 

(TCZSRCVE) 

An error has occurred in 

VTAM processing (apparent 

VTAM error). 

VTAM has encountered an error 
in its own processing of the 
request to or from the 
logical unit. 

X* 60E002" 

DFH2409 

X*D0 f 

(TCZTXCS) 

VTAM recovered node. 

VTAM has successfully re¬ 
established communications 
with the node. 

CICS/VS will reinitiate a 
session with the node. 

X'60E001" 

DFH2410 

X B D1" 

(TCZTXCU) 

Node unrecoverable. 

VTAM cannot reestablish 
communications with the node. 

X* 60E001'* 

DFH2411 

X'EO' 

(TCZDMSN) 

Node attempted invalid logon. 
An unknown node has attempted 
a logon. The symbolic node 
name is contained in the 
first 8 bytes of the message. 

X"000000* 

DFH2412 

X* El" 

(TCZDMRA) 

Receive-any problem. 
Receive-any initiation 
failed. 

VTAM may be in termination. 

X* 400000* 

DFH2413 

X"E2 * 

CTCZDMCL) 

Node CLSDST failed. 

X* 000000 1 * 


The CLSDST of a node in 
logon exit has failed. 
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Action 

Flags 


• VTAM storage problem. 

• Apparent VTAM error. 

DFH2414 X^O' (TCZSRCSP) Temporary VTAM storage X"000000" 

problem. 

VTAM has run short of avail¬ 
able working storage. This 
situation should eventually 
terminate. 

Not defining enough VTAM 
buffer storage at VTAM 
generation creates such 
a problem. 

DFH2415 - Node out of service. 

The node has been taken out 
of service by CICS/VS 
because of an earlier node 
error condition. 

DFH2416 X'lS' (TCZSRCVH) VTAM is halting. X’ 000002'" 

The HALT QUICK command 
was entered by the 
network operator while a 
SIMLOGON or OPNDST 
request was in progress. 

DFH2417 X*ID* (TCZSRCVI) VTAM inactive to CICS/VS. X*000000* 

• CICS/VS has failed to 
open its VTAM ACB. 

X^O* (TCZVTAMI) • VTAM was halted. 

DFH2418 X'BB 1 * (TCZSEXUC) Unknown indicator in RPL. X* 60E003 1 * 

SESSIONC exit, while vali¬ 
dating the RPL at completion 
for a SESSIONC request, was 
unable to determine which 
SESSIONC indicator was sent. 

• Invalid RPL address. 

• RPL was altered. 

DFH2419 X 1 82* (TCZSSXUC) Unknown indicator in RPL. X*60E003' 

Send-data-flow synchronous 
exit was unable to validate 
the indicator sent. 

• Invalid RPL address. 

• RPL was altered. 

DFH2420 X f B5* (TCZSAXUC) Unknown indicator in RPL. X^OEOOS 1 

Send-data-flow asynchronous 
exit was unable to validate 
the indicator sent. 


Error Error Code 

Message (Symbolic Label) Condition 
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Error 

Message 


DFH2421 


DFH2422 


DFH2423 


DFH2424 


Appendix 


Error Code 

(Symbolic Label) Condition 


Action 

Flag? 


X^O* (TCZUNCMD) 


X - 90 * (TCZLGCER) 


X* 74 1 (TCZSDSE5) 


X'75 ,f (TCZSESE1) 


• Invalid RPL address, 

• RPL was altered. 

Unsupported indicator 
received, 

Receive-specific exit or 
receive-any has received an 
indicator it cannot handle. 

• If DFHZNAC finds that 


the message is not an 
LU status message, the 
indicator is definitely 
unsupported. 


• RPL was altered. 

DFHZCP logic error. 

OPNDST, SIMLOGON Or CLSDST 
has detected one of the 
following: 

• OPNDST — node has 
already been opened. 

• SIMLOGON — node has 
already been logged on. 

• CLSDST — CLSDST-activate- 
request bit is not on. 

Incomplete command request. X* 20E001 ,f 
A request to send-data-flow 
synchronous command was 
made with incomplete bit 
settings. 

• TCTTE has been altered. 

• Requesting module has a 
logic error. 

• TCTTE was queued in¬ 
advertently to send 
synchronous. 

Command request invalid. X'^OEOOl* 

SESSIONC command request 
bits are invalid or incom¬ 
plete. 

• TCTTE has been altered. 

• Command request bits are 
incomplete. 

• Queued inadvertently to 


X ,f 60E0001* 


Note: 

If the 
indicator 
proves to be LU 
status, see 
system sense 
table below. 


X'* E0E002 * 
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Error 

Message 


DFH2425 


DFH2426 


DFH2427 


DFH2428 


DFH2429 


DFH2430 
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Error Code 
(Symbolic Label) 


Condition 


Action 

Flags 


X f B2 1 (TCZSDAUC) 


X * 94 1 (TCZRACES) 


X'C5 W (TCZSRCNA) 


X'92" (TCZSDSE6) 


X B 91'" (TCZRSTLE) 


X* 78 * (TCZSDRE2) 


SESSIONC. 

Command request invalid, X B 20E001 B 

Send-data-flow asynchronous 
command request bits are 
invalid or incomplete, 

• TCTTE has been altered, 

• Command request bits are 
incomplete. 

Input status error- X f 60E000 f 

The receive-any module 

received data from a node 

in one of the following 

conditions: 


• Node is permanently out 
of service. 

• TCT specifies node as an 
output only device. 

NCP/VS restarted. X B 400000 B 

NCP/VS has been restarted 
after failing while an 
OPNDST was in progress. 

Send-synchronous request X B 20A000 B 

incomplete. 

A send-synchronous request 
failed to indicate whether 
a command or data was to be 
sent. 


• TCTTE has been altered. 

• Inadvertently queued to 
s e nd-synchronous. 

Invalid RTYPE. X B 206000 IB 

An incorrect RESETSR request 
was made. 

• The requestor failed to 
specify or incorrectly 
specified the RTYPE. 

• TCTTE was inadvertently 
altered. 

Indicator request invalid. X f 20A002* 

A send-response request was 
made in error. 


• Request failed to specify 
whether response was to 
be FME or RRN. 
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Error Error Code 

Message (Symbolic Label) 


DFH2431 X* CB* (TCZSRCTC) 


DFH2432 X § Bl m (TCZSSXNR) 


DFH2433 X*BA* (TCZSEXNR) 


DFH2434 X*43* (TCZCPYNS) 

DFH2435 X*96* (TCZRVSZl) 


DFH2436 X’97* (TCZRVSZ3) 


DFH2437 X*73* (TCZSDSE4) 


V 


Condition 


• TCTTE has been altered. 

Request to a released node. 

If the ACB is open, this 
is a DFHZCP logic error. 

If the ACB is closed, 

CICS/VS is halting and the 
CLOSE ACB has been issued. 

Exception response received. 

A SEND DFSYN exit received 
an exception response. 

An exception response to a 
bid was received, containing 
sense information which does 
not pertain to the expected 
RTR sense. 

Exception response received. 
SESSIONC exit received an 
exception response. 

An exception response to a 
SESSIONC command was re¬ 
ceived from the logical 
unit. CICS/VS requires 
a normal response. 

Source not valid for copy. 

RPL missing. 

Receive-specific was acti¬ 
vated without an RPL. 

• CICS/VS error such that 
an RPL is expected to 

be present on entry into 
the receive-specific 
module but has been freed 
or was never allocated. 

• TCTERPLA was altered. 

TIOA missing. 

Receive-specific found the 
original TIOA in an over¬ 
length data condition 
missing. 

• CICS/VS error such that 
the original TIOA was 
freed. 

• TCTTEDA was altered. 

Read-only node. 

A DFSYN SEND was scheduled 
for an input-only device. 

• TCTTETS was altered. 


Action 

Flags 


X* 60E002'* 


X’* 000002* 


(See system 
sense table 
below.) 


(See system 
sense table 
below.) 


X 11 20200 0* 
X f 206001* 


X" 206001* 


X*20A000' 
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Error 

Message 


DFH2438 


DFH2439 


DFH2440 


DFH2441 


DFH2442 


DFH2443 


DFH2444 
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Error Code 

(Symbolic Label) Condition 


Action 

Flags 


X* Al 1 (TCZRVSZ2) 


X * 98 * (TCZACT01) 


X*D7 * (TCZSXC1) 


X"D6" (TCZSXC2) 


X"DC" (TCZPXE1) 


X"59" (TCZROCT) 


X"A3" (TCZBKTSE) 


• Task was attached that 
does a SEND. 

Invalid read request. X" 206000'" 

A read (RECEIVE) request 
was attempted for a receive- 
output only device. 

• Task was attached that 
issued a read. 

• TCTTETS was altered. 

Invalid resume request. X"200000" 

Activate scan found a TCTTE 
to resume (but a task was 
not attached),. 


• TCTTECA was altered. 

• CICS/VS encountered a 
logic error such that 
the task was detached, 
yet the resume flag was 
left on in the TCTTE. 


CICS/VS quiesced by node. 
The node has indicated that 
all data flow to it should 
stop. 

Temporarily cannot store 
any more data. 


X"000000" 

(Information 

only) 


CICS/VS released by node. 
The node is now ready or 
capable of receiving data 
from CICS/VS. 


X* 000000'* 

(Information 

only) 


Exception response received 
to a definite response send. 

Response exit received an 
exception response. 

Request outstanding. 

• A receive request was 
outstanding on a node 
at system shutdown time. 

• The high order bit in 
the NIB address-field was 
turned on by DFHZNAC, 
indicating no further 
communication should be 
attempted with this node. 

CICS/VS bracket state error. X"60E000" 
Application program violated 
CICS/VS bracket protocol. 


(See system 
sense table 
below.) 


X"60E000" 
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Error 

Message 


DFH2445 


DFH2446 


DFH2447 


DFH2448 


DFH2449 


Error Code 

(Symbolic Label) Condition 


Action 

Flags 


X* 95 " (TCZSDSE8) 


X* 84 * (TCZSSXIB) 


X* A5* (TCZMIE) 


X"65" (TCZINVRR) 


X" A7'* (TCZBOEB) 


Application issued a DFHTC 
read after a WRITE LAST. 


Output area exceeded. X"20A000* 

TIOA length error. 

• Application set up 
TI0ATDL incorrectly. 

• Application overran the 
TIOA. 


Invalid response to bid. X*60E003* 

A normal response was re¬ 
ceived to a bid while in 
bracket state. 

The 3601 application 
program is in error. It 
has lost track of the 
bracket status of the node. 

Message exceeds maximum X"606000" 

input. 

Either receive-any or 
receive-specific received 
more data than the user- 
defined system maximum. 

Hardware problem such that 
the current buffer is con¬ 
tinuously sent without any 
operator intervention. 

Invalid response requested. X"606003* 

Receive-specific, receive- 

any or receive-specific exit 

received data from the 

logical unit without 

a response requested 

(FME-RRN). RPL altered. 


Bracket error. 

Receive-specific exit or 
receive-any received either 
a begin bracket when already 
in bracket state, or an end 
bracket, or data not marked 
by begin bracket after CICS/VS 
had sent an end bracket. 

• Logical unit X*602003* 

sending end bracket is 

not currently supported. 

• Logical unit sent begin X - 602000* 

bracket when already in 
bracket state. 

• Logical unit sent data X*602000" 
not marked by begin 
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Action 

ElM.5— 


bracket after CICS/VS 
had sent an end bracket. 

DFH2450 X*83'* (TCZSSXAR) Bid issued but ATI canceled. X" 000000" 

The ATI which caused a bid 
to be sent was canceled. 

• The ATI was time- 
initiated dependent. 

• CICS/VS error. 

DFH2451 X - CC - (TCZSRCCI) Outstanding request when X'60E000' 

clear was issued. 

A request (receive-specific) 
was outstanding when clear 
was issued by CICS/VS or 
by VTAM. 

• A clear-unbind was issued 
by VTAM when communica¬ 
tion with the node was 
lost (LOSTERM exit node 
unrecoverable). 

• CICS/VS terminated the 
session (CLSDST). 

• CICS/VS issued the clear 
in an effort to clean up 
or resynchronize the 
session. 


DFH2452 

X f D5' 

(TCZCXE2) 

Invalid indicator received. 
Session control input exit 
received an indicator from 
the logical unit 
other than request 
recovery. 

X* 20E003" 

DFH2453 

X* D4 * 

(TCZCXRR) 

Request recovery received. 
The logical unit 
has indicated that recovery 
processing is needed. 

X"OOEOOO" 

DFH2454 

X" CD * 

(TCZSRCCX) 

Exception in chain. 

Exception response returned 
on a POST=RESP chained data 
send. 

X*60E000" 




• Error within CICS/VS. 

CICS/VS does not send 
chained data with 
POST=RESP. 





• VTAM error. 


DFH2455 

X'93" 

CTCZRACET) 

Continue-any mode with task 

X’60E001* 


attached. 

The node was in continue-any 
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Error Error Code 

Message (Symbolic Label) Condition 



Error 

Message 


DFH2456 

I 

I 

I 

DFH2457 


DFH2458 

DFH2459 

DFH2467 

DFH2468 


Appendix 


Error Code 
(Symbolic Label) 


Condition 


Action 

Flags 


mode, yet a task was still 
present. 

Task presently on the node 
should have been abnormally 
terminated, but was not. 

The node was closed and 
simulated logged on, which 
put it into continue-any mode. 


* 44 * (TCZSRCDE) 


•D8 f (TCZRNCH) 


1 DD f (TCZPXEZ) 


'99' (TCZSDSE7) 


# 88* (TCZLEXCI) 


*89’ (TCZLEXUS) 


Received exception response 
to a command. 

Logical unit sent an 
exception response to a 
command. 

CICS/VS does not support an 
exception response from the 
logical unit to a command 
other than bid. 


(See system 
sense table 
below.) 


Multiple catastrophic errors X*60E001 f 
encountered. 

More than one consecutive 
error has been encountered 
by a node without the first 
error being processed. 

That is, while DFHZNAC is pro¬ 
cessing the first error en¬ 
countered with a node, 
another synchronous error 
occurs which overlays the 
previous error code. 

Received exception response (See system 
to exception response SEND. sense table 

below.) 


No TI0A available for SEND. X’20A000 ,B 
TI0A for SEND was not avail¬ 
able. 

TCTTEDA was not loaded prior 
to issuing the DFHTC 
TYPE=WRITE macro or was in¬ 
advertently cleared. 

Invalid CID detected. 

A VTAM request was made 
with an invalid CID. 

TCTECID was altered. X*60E002 - 

Unknown symbolic name. X’60E002" 

A request was made to VTAM 
with an invalid symbolic 
node name. 

• Symbolic name altered 
in the NIB. 

• VTAM definition and TCT 
entries do not agree. 
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Error Error code Action 

Message (Symbolic Label) Condition Flags 

DFH2469 X*D9' (TCZYX43) Exception response received. 

An exception condition 
exists for an inbound 
message. . 

Invalid sequence numbers. 

DFH2470 X'DA" (TCZSXC3) Request shutdown received X"60E001* 

while task active. 

• The controller application 
program sent RSHUTD 
(Request Shutdown) on 
behalf of a node while a 
task was still attached. 

• During VTAM shutdown, a 
shutdown complete indicator 
was received from the 
controller application 
program on behalf of a 
node while a task was 
still attached. 

• During VTAM shutdown, a 
task was still attached to 
a VTAM 3270 (which cannot 
send request shutdown or 
shutdown complete). 

DFH2471 X'A8" (TCZFMHLE) FMH length error. X* 606000 * 

The function management 
header length was greater 
than that of the data 
received from the logical 
unit. 

• The logical unit built 
; the FMH incorrectly. 

• Transmission error. 

DFH2472 X'A9* (TCZRACRF) Unable to retrieve over- X"002000' 

length data. : 

The receive request for the 
. remainder of data that 

in excess of the receive any 
input area, was not accepted 
by VTAM. 

DFH2473 X'AA' (TCZSDSE9) Outbound chaining not X'20A000' 

supported. 

The CICS/VS application 
program has attempted to 
send more data to the 
logical unit than its 
generated maximum permitted 
length, and the logical unit 
does not support outbound 
chaining. 
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sense table 
below.) 


692 



Error Error Code 

Message (Symbolic Label} 

DFH2474 X'79* (TCZATINS) 

DFH2477 X*18* (TCZLRCNR) 

DFH2482 X’93" (TCZRACET) 


DFH2485 X*E3* (TCZCNCL) 

DFH2486 X’9B' (TCZRACNL) 

DFH2487 X*9C* (TCZOCNL) 

DFH2488 

DFH2489 X*40* (TCZINCPY) 


DFH2490 X"41 1 (TCZTOLRQ) 

Appendix E. Error Messages 


Condition 


ATI not supported• 

A task was automatically 
initiated for a logical unit 
which was defined at table 
generation time as not 
supporting ATI. 

This LU does not support 
chained data from the host. 
The amount of data being 
transmitted to the LU exceeds 
the length specified in the 
buffer operand of the TCT 
macro. 

Pipeline session bracket 
error. The terminal was 
defined in the terminal 
control table (TCT) as 
running in pipeline session 
mode but either the BRACKET 
operand in that definition 
was omitted or was specified 
as BRACKET=YES• Bracket 
protocol is not enforced on 
a pipeline session terminal. 

Cancel received in "CS" 
mode. A CANCEL indicator was 
received while a task was 
active. 

Cancel received in "CA" 
mode. A CANCEL indicator was 
received while no task was 
active. 

Outbound chain canceled. 

An outbound chain was not 
completed at task detach 
time. 

Inbound chain purged. 
Unprocessed inbound data 
remained at task detach time. 

3270 - Invalid copy request. 
The terminal control table 
terminal entry (TCTTE) of the 
"from" device did not specify 
the COPY feature, or the 
"from" device is not defined 
in the TCT, or is not a 
3270, or is not connected to 
CICS/VS via VTAM. 

Request for TOLTEP. 

On a request for TOLTEP, a 
receive request completes 
in error. 


and Codes 


Action 

Flag? 

X*200000* 

X’*20E000* 

X"60E001* 

X* 20E000 ’ 

X'* 2OEO0O* 

X* 20E000* 

X* 000000" 

X* 20AOOO * 

X"60E001" 
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Error 

Message 

DFH2491 

DFH2495 


DFH2496 


DFH2497 

I 

DFH2499 


DFH3400 


| DFH3401 
| DFH3402 

I 

I 


Error Code 
(Symbolic Label) 


Condition 


Action 
Flags, 


X'E4' (TCZSXC4) Segmenting error. X'60E001' 

A segmenting error was 
detected by the LOSTERM exit. 

DFHZNAC has performed an 
interval control PUT to a 
3270 printer on behalf of 
DFH2497 unavailable printer 
condition. The printer is 
out of service, requires 
intervention, or does not 
have RECEIVE or TRANSCEIVE 
status. The request is queued. 

X'42' (TCZUNPRT) DFHZNAC has attempted to X'000000' 

perform a DFHIC TYPE=PUT 
macro instruction, as the 
result of a DFH2497 
unavailable printer error. 

The DFHIC TYPE=PUT 
terminated with one of the 
four errors that can occur 
when issuing that macro 
instruction: 


IOERROR 

TRNIDER 

TRMIDER 

INVREQ 

x* 42 * (TCZUNPRT) Unavailable printer. X*000000' 

A print function was requested 
on a 3270 display and neither 
the "PRINTTO" nor the "ALTPRT" 
printer was available to 
receive the information. 

X'E5' (TCZRUER) RU exceeds RUSIZE at maximum X"206000* 

chain size. If chain 
assembly has been specified 
in the TCTTE, the request unit 
(RU) read in is bigger than 
the remaining space in the 
TIOA and bigger than the 
maximum RUSIZE. 


X'45' (TCZCHMX) Chain exceeds maximum chain X*206000' 

size. If chain assembly has 
been specified in the TCTTE, 
the chain being assembled does 
not fit into the TIOA for a 
maximum chain. The remaining 
space in the TIOA is smaller 
than the maximum RUSIZE. 

Resource now available. X'400000'' 

X'46" (TCZOCIR) Invalid read. X'206000* 

A DFHTC TYPE=READ request is 
being processed although the 
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Error 

Message 


| DFH3403 

| DFH3404 

| DFH3405 
| DFH3406 
| DFH3407 

| DFH3408 

| DFH3409 
DFH3410 

| DFH3411 
| DFH3412 
| DFH3413 

| DFH3414 

I DFH3415 


Error Code 

(Symbolic Label) Condition 


Action 

Elaas. 


X'DE* (TCZFSMD) 


previously issued DFHTC 
TYPE=WRITE request did not 
complete a chain* 

Failed to get in send mode. X*20E000' 
CICS/VS could not break the 
inbound data flow in order 
to send a message to the 
logical unit* 

Bind parameters too long. X B 60E00r* 

The bind area received from 
the logical unit during logon 
is too long. 


Catastrophic bracket error. 

Parameter error. 

Read command does not carry 
change direction. 

Presentation space integrity 
lost. 

RPL active or not available. 


X f 60E201• 
X B 60E000 B 
X f E06001* 

X* 60E000* 


X 1 BC B (TCZINIIR) Input other than LU status X B 60E000 B 

message received after system 
sense "0802* (intervention 
required), or B 0807 B (resource 
temporarily unavailable). 

Resource temporarily X*000000* 

unavailable. 

Intervention required on X*000000' 

secondary resource. 


Logical unit has rejected a X'000000' 
request because its resources 
were busy. 


Secondary resource of a X*60E000' 

logical unit is permanently 
unavailable to complete a 
request (no printer was 
available for a print request). 

A receive request has been X*600000" 
rejected by the LU because: 

• The device cannot perform 
an input operation (for 
example, a printer) 

• The LU is not able to send 
data at that time (for 
example, a 3790 data set 
is not available) 
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Error 

Error Code 


Action 

Message 

(Symbolic Label) 

Condition 

Flags 

DFH3416 


The logon requested was to 

X*60E000* 


be rejected, but VTAM rejected 
the attempt to send a negative 
response- 


DFH3417 X'50* (TCZSDRE3) A sync point request has X*002000* 

been ignored. Neither 
commit nor abort has been 
issued. 

DFH3418 X*51 w (TCZBDPRI) The name in the bind area X^OEOOl* 

matches a primary TCTTE. 

The TCTTE generation should 
specify a secondary. 

DFH3419 X*52'* (TCZBDUAC) The requesting system has X* 680000* 

passed unacceptable bind 
parameters. 

DFH3420 X*53* (TCZBDTOS) LOGON was requested for a X* 000000* 

terminal that had not been 
placed in service. 

DFH3421 X*5A* (TCZSBIRV) A shutdown request was X* 000000* 

received for the system, and 
an orderly termination 
procedure was begun. 

DFH3422 X*5B* (TCZNSP01) An error occurred while X*60E003* 

trying to establish an ISC 
session. The request was 
terminated before the session 
was established. 

DFH3424 X*5C* (TCZNSP02) Communication with a node was X*60E003* 

interrupted in the middle of 
a session because: 

• A session outage was detected 

• A VTAM VARY INACT command 
was issued. 

DFH3425 Either one side of the 

intersystem link has not 
recovered sequence numbers, or 
sequence numbers mismatch is 
such that it could not have 
been caused by a session 
failure alone. 

DFH3426 No TCTTE could be found X*000000* 

during intersystem connection. 

DFH3427 During intersystem X*000000' 

connection, one or more 
parameters contained in the 
requests*s bind area was 
invalid or was not supported. 
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Error 

Message 

| DFH3428 

J DFH3429 

| DFH3430 

I 

| DFH3431 

| DFH3432 

| DFH3433 

| DFH3434 

| DFH3435 

| DFH3436 

I DFH3437 


Error Code 
(Symbolic Label) 


Condition 


Action 

Flags 


X*EB' (TCZSTRMH) 


CICS/VS expected a resynch¬ 
ronization process to occur 
during session initiation, 
but the resynchronize. 


X"EC 1 (TCZSTRMM) Resynchronization error. 


X - 200000* 


X"600201* 


X* ED * (TCZSTON) 


X*EF" (TCZSTIN) 


X* EA* (TCZSTLER) 


X"58 * (TCZERMGR) 


X* 54 * (TCZUNBIS) 


X* 600000 1 


X* 600000* 


X'* 600000'* 


X*000000* 


CICS/VS did not resynchronize 
and the other LU was expecting 
resynchronization. 

Resynchronization error. 
Outbound flow sequence numbers 
do not agree with those of the 
other LU. 

Resynchronization error. 

Flow sequence numbers do not 
agree. 

Resynchronization error. 
Unexpected code received in 
response to STSN. 

One side of the intersystem 
link sent a negative response 
or LUSTAT with code X* 0846'*, 
implying that an error message 
is the next message to follow. 
The sense code obtained from 
within the message is used to 
drive any appropriate actions. 


One side of the intersystem X*60E001* 

link (the secondary LU) 

received an UNBIND command 

without the normal termination 

protocol being observed. An 

abnormal termination of the 

session was performed, probably 

caused because the other side 

of the link abnormally 

terminated. 

Path error detected. VTAM X 1 * 60E003* 

can no longer transmit to a 

device because there is no 

access path to that device 

(the device may have been 

powered off). 

A sense code has been X"00E000* 

indicating that an unauth¬ 
orized request was made to 
the remote node. The request 
was rejected. 

After an error has been 
processed by DFHZNAC, certain 
errors may be taken to "correct" 
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Condition 


Action 

.Elagjs-. 


Error Error Code 

Message (Symbolic Label) 


| the error. This message lists 

| the actions taken. 


SYSTEM SENSE CODES RECEIVED 


The following list indicates the actions taken by DFHZNAC upon receipt 
of inbound system sense codes. If no system sense code is received, no 
action is taken by DFHZNAC. However, the user sense code is available 
for analysis by the user B s node error program. Refer to Figure 5.2 for 
details of the action flags set by DFHZNAC. 


System 


Sense 

Action 

Error 

Received 

Flags 

Messaqe 

X'0801" 

X'20E000" 

DFH2476 

X* 0802" 

X" 600000'* 

DFH2461 

1 x"0806" 

X*000000" 

DFH3426 

x*o807* 

X* 600000" 

DFH3411 

X* 080B" 

X* 60E001" 

DFH2462 

| X" 080F" 

X* 60E201* 

DFH2462 

X* 0811' 

X* OOEOOO" 

DFH2464 

X'0812’ 

X*400000" 

DFH2465 


Condition 


A component of the logical unit 
is no longer available. 

Probable cause is a device 
error or loss of contact. 

Intervention required. 

Forms are required at an output 
device. See note 1 below. 

TCTTEs do not match. 

Resource temporarily not 
available. See note 1 below. 

Bracket error. 

Task initiation attempted by 
both the logical unit and 
CICS/VS. 

End user not authorized. 

Break. 

Chain rejected by the logical 
unit when purging incoming 
messages following error 
recovery. 

Insufficient resources. 

• Diskette data set is 
full. 

• Data segment not large 
enough to handle data 
set. 


• Component temporarily not 
available. 

X , 081B I X 1 600000* DFH2483 Receiver in transmit mode. 

CICS/VS System Programmer's Reference Manual 


698 



System 

Sense Action 

Received Flags 


Error 

Message 


Condition 


X* 081C" 

X 1 0824" 

X* 0825 1 

X'0827* 

X"0829* 

| X*082A* 
X"082B* 

X*082D* 


X 1 60E000* 

x*6oeooi* 


X f 60E000 * DFH2466 

X* 60E001* 


X* 20E000* DFH2475 

X* 60E000 * DFH2484 

X 1 200000'* DFH2480 


X* 60E001 1 DFH3407 

X* 008000 * 

X* 60E000 * DFH3408 

X* 600000* DFH3413 


Action flag X*600900* is set 
for negative response received 
to a send which requested 
a definite response. 

X*60E000* is set for negative 
response to an exception 
response send, or if end 
bracket has been sent. 

X* 60E001* forces close 
destination to be issued. 

This action is set if CICS/VS 
is not in send mode. 

Function not executable. 

The logical unit cannot 
deliver the message to the 
node because of a data check 
condition or because the node 
is not available. 

X* 60E001 1 forces close 
destination to be issued. 

This action is set if the 
response was received for an 
SNA command sent by CICS/VS. 

The logical unit has aborted 
all current processing with one 
of its components because 
failure or loss of contact 
with that unit. 

Component not available. An 
An application request could 
not be satisfied. 

The logical unit has requested 
retransmission of data from 
the host. This applies only 
to those transactions with 
message integrity or to requests 
using definite response 
protocol. 

The request requires the 
change direction indicator 
to be set. This was not done. 


Presentation space error. 

Error on display or in 
buffer due to hardware error: 
for example, regen buffer 
parity error. 

Logical unit busy - unable 
to process request. See note 1 
below. 
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System 

Sense 

Received 


Action 

Flags 


Condition 


X* 082E* 


X'082F* 


I x*0833’ 
| X* 0847" 

I 

X'084A* 


X'1001* 

or 

X'1002* 


X*1003* 
or 

X * 1005* 


X* 1005’* 


X" 1008* 


Error 

■tteaaa ge. 

X 1 600000 * DFH3412 

X 1 60E000 * DFH3414 

X*000000* DFH3427 

X*000000* DFH 

X’OOOOOO* 


X"60E000 * DFH2481 


X* 60E000* DFH2479 


X* 60E000* DFH3406 


X* 60E000 * DFH2478 

X*00C000* 

X*000000* 


Intervention required on 
secondary resource; resource 
is currently not available. 

See note 1 below. 

Request not executable. 

Secondary resource 
unavailable. 

Error in bind (format). 

Negative response received 
to SDT. 

Presentation space altered. 
Display buffer alteration, due 
to operator intervention, 
detected on a READ command to 
a compatibility mode logical 
unit. Note that 082A received 
in response to a send request 
is not treated as an error 
condition. 

The RU (request-response 
unit) transmitted to the 
logical unit was either 
untranslatable or its length 
was too long or short. 

The RU (request-response unit) 
passed to the logical unit 
is not a supported function. 
Either a transmission error 
or data overlaying the RU 
caused the problem, or SCS 
parameters are not supported. 

Parameter error. 

The RU received by the logical 
unit contains a control function 
with invalid parameters. 

Invalid FMH. 

Invalid length/type field 
in TIOA received with FMH, or 
invalid FMH parameters. 

If the request was not made 
by means of the batch data 
interchange program, the action 
flags are set to X*60E000*. 

If DFHDIP was used, an action 
flag of X w 000000 ,, is set if 
DFHDIP determines that it can 
handle the situation, and 
X*OOCOOO* is set if the error 
occurs on an exception response 
made by DFHDIP. In both cases, 
control returns to DFHDIP, 
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System 

Sense 

Received 


Action 

Flags 


Conflitipp 


Error 

Message 


X* 200 3* X* 60E001'* DFH3405 


X^OOB* X f 20A000 ,i DFH2477 


Other X" 60E003* DFH2460 

codes 


which in turn passes control to 
the application program with an 
appropriate DFHDIP return code. 
Further information on DFHDIP 
can be found in the appropriate 
CICS/VS Application 
Programmers Reference 
Manual . 

Catastrophic bracket error. 
CICS/VS attempt to start a 
bracket conflicted with the 
receiver's understanding of 
the current bracket state. 

The logical unit does not 
support chained data from 
the host. Consideration 
must be given to the amount 
of data to be transmitted 
to the logical unit. 

Sense received not supported. 
Sense codes not supported 
by CICS/VS were received 
from the logical unit. 

If zero system sense provided, 
the user sense may indicate 
the source of the error. 

Note that codes X'0813* and 
X* 0814 1 are handled entirely 
by CICS/VS without DFHZNEP 
intervention. 


The following codes may arrive as LUSTATUS command codes only. In 
addition, some codes of the X'OSxy* type may also be sent via LUSTATUS 
and are handled in the same way as when sent via negative response 
system sense: 


System 

Sense 

Received 

Action 

Flags 

Error 

Message 

Condition 

X'0001* 

X" 400000* 

DFH3401 

Component now available. 

X’0002" 

X" 206000* 

DFH3415 

No data available. Logical 
unit has no data to send. 

Note 1: 
3650, or 

For logical unit types 1, 2, 
3790 inquiry logical units) 

and 3 (that is, other than 3600, 
CICS/VS will not retry the failing 


request until it receives an LUSTATUS command with the system sense code 
of X'0001 1 . If the LUSTATUS system sense received is not X w 0001 f , the 
resultant error action code will apply to the original request. 


If sense/status information is received from a 3270, one of the 
following three messages will be issued in addition to DFH2442, DFH2458, 
or DFH2469. 


Appendix E. Error Messages and Codes 


701 



3270 Action 

aense/Status Flags 


Error 

Message 


Condition 


X*0210' X"600000' DFH2492 Intervention required on 3270 

printer. 

• Printer out of paper, cover 
open, or offline. 

• Transaction request to 
start printer, but no 
printer present. 


• Printer adapter feature 
not present. 


X’0010' 

X'600000* 

DFH2493 

Intervention required on a 
device in the 3270 




Information Display System. 

xxxx 

X'60E000'' 

DFH2494 

Error status message 


received from a device in 
the 3270 Information Display 
System. The message contains 
the sense/status received. 

Detailed information on 3270 sense/status is given in the 3270 
Information Display System: Component Description manual. 
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Appendix F. Sample TCAM SNA Message Control 

Programs 


The following Appendix contains two sample TCAM SNA message control 
programs (MCPs). The MCPs given have the following functions: 

• Sample 1: - control of the SNA sessions is independent of the 

CICS/VS application programs 

• Sample 2: - controls the SNA sessions according to the 

requirements of the CICS/VS application programs 

Further information on TCAM devices in a TCAM SNA environment and on 
MCPs for TCAM SNA devices is given in Chapter 5.3 under "CICS/OS/VS/TCAM 
SNA Considerations". 


SAMPLE 1: '* DFHSPTM1 - SAMPLE TCAM MCP FOR TCAM DIRECT 1 


*********************************************************************** 

♦ 

♦ 

* 

* NAME - CICS SAMPLE TCAM MESSAGE CONTROL PROGRAM AND MESSAGE HANDLERS 

* (INDEPENDENT CONTROL) 

* 

* PURPOSE - THE PURPOSE OF THIS SAMPLE IS TO DEMONSTRATE TO THE CICS 

* USER WHAT IS REQUIRED FOR THE CREATION OF A SIMPLE CICS SNA 

* NETWORK USING TCAM. THE SAMPLE DEMONSTRATES HALF-DUPLEX 

* FLIP/FLOP MODE WITH BRACKETS. 

* 

♦ 

♦ FUNCTIONS - THE FUNCTIONS ARE AS FOLLOWS: 

♦ 

* INTRODUCTION - DEFINE THE OVERALL SYSTEM PARAMETERS, INITIALIZE 

* THE SYSTEM, AND START MESSAGE TRAFFIC. 

* 

♦ DEFINITION - DESCRIBE THE SPECIFICS OF THE NETWORK, THE MESSAGE 

♦ QUEUES, AND THE NECESSARY CONTROL BLOCKS. 

♦ 

* DEVICE MESSAGE HANDLER - INSERT THE COMMUNICATIONS CONTROL BYTES 

* AND ROUTE THE MESSAGE FOR INPUT, REMOVE THE CCB AND ROUTE 

* THE MESSAGE TO ITS PROPER DESTINATION ON OUTPUT. THE DMH IS 

* NAMED 'CICS' SO THAT AN LU CAN LOGON TO 11 CICS*. 

* THIS MH SUPPORTS LU TYPEO, TYPE1, AND TYPE2. THE SUPPORT IS 

* DESIGNED TO ALLOW THE DEVICE MH TO CONTROL THE LU. 

* LU TYPE 1 SUPPORT: 

* THE LU MUST BE BOUND TO ALLOW IT TO SEND END BRACKET. THE HOST 

* WILL BEGIN AND END A BRACKET ON EVERY CHAIN EXCEPT WHEN A 

* DATASET IS BEING SENT. IN THIS CASE THE BRACKET WILL NOT BE 

* ENDED UNTIL THE END OF DATASET. OTHER METHODS OF OPERATION 

* ARE POSSIBLE BY USING DIFFERENT MH OPTIONS. THE LU TYPE 1 

* BATCH SUPPORT ASSUMES A SINGLE TRANSACTION WILL HANDLE THE 

* BATCH INPUT. THE MH WILL EDIT THE TRANSACTION NAME INTO 

* THE FIRST CHAIN OF THE DATASET. THEREFORE IT IS NOT NECESSARY 

* TO PLACE A TRANSACTION NAME INTO THE DATASET. 

* LU TYPE 2 SUPPORT: 

* LU TYPE 2 IS THE 3270 DATA STREAM EMULATOR. 
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* THE SUPPORT IS DESIGNED TO ALLOW THE TRANSACTION TO OPERATE 

* INDEPENDENTLY FROM THE OUTBOARD LU. THEREFORE THE KEYBOARD 

* IS UNLOCKED AFTER EVERY INPUT. SINCE AN LU TYPE 2 CANNOT BE 

* BOUND TO SEND END BRACKET A MSGGEN IS USED TO UNLOCK IT. 

* ALSO THE HOST WILL BEGIN AND END A BRACKET ON EVERY CHAIN. 

* THIS WILL CAUSE THE KEYBOARD TO UNLOCK AFTER EVERY OUTPUT 

* MESSAGE. IF A DIFFERENT METHOD OF OPERATION IS DESIRED 

* LOGIC COULD BE ADDED TO ONLY END THE BRACKET WHEN THE KEYBOARD 

* UNLOCK SEQUENCE IS SENT. 

* 

♦ 

* APPLICATION MESSAGE HANDLER - ROUTE MESSAGES FROM THE INPUT QUEUE 

* TO CICS AND FROM CICS TO THE APPROPRIATE OUTPUT QUEUE. 

* 

♦ 

* THE SSCP MESSAGE HANDLER - UTILIZES THE IBM-SUPPLIED MH TO 

* PERFORM THE NECESSARY ROUTING AND ANALYSIS FUNCTIONS. COMPLEX 

♦ USER SYSTEMS MAY REQUIRE THIS TO BE MODIFIED BY THE USER. 

♦ 

♦ 

♦ NOTES - 

* 

* CONVENTIONS - 

♦ 

* REGISTER 2 IS USED AS THE DCB REGISTER 

♦ 

* REGISTER 3 USED AS INTERNAL LINKAGE REGISTER 

♦ 

* REGISTER 4 USED AS INTERNAL WORK REGISTER 

♦ 

* REGISTER 5 USED AS INTERNAL WORK REGISTER 

♦ 

* REGISTER 6 USED AS THE SCAN POINTER REGISTER 

♦ 

♦ DEFAULTS - 

♦ 

* MACRO DEFAULTS ARE USED WHEREVER REASONABLE 

* 

* 

♦ EXITS - 

♦ 

* NORMAL - 

♦ 

* RETURN TO THE OS/VS SUPERVISOR WHEN SHUTDOWN IS COMPLETE 

♦ 

* ERROR - 

* 

* x'FFF" - ABEND ON INTRO FAILURE 

* 

* X’FFE* - ABEND ON MESSAGE QUEUE DCB OPEN FAILURE 

* 

* X B FFD f - ABEND ON 3705 DCB OPEN FAILURE 

* 

* 

* 

♦ 

*********************************************************************** 


CICSTCAM 

CSECT 



RDCB 

EQU 

2 

DCB REGISTER 

LINKREG 

EQU 

3 

INTERNAL LINKAGE REGISTER 

RWORK 

EQU 

4 

INTERNAL WORK REGISTER 

RSCANSVE 

EQU 

5 

SAVED SCAN POINTER REGISTER 
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RSCAN 

EQU 

6 

SCAN POINTER REGISTER 

RRETURN 

EQU 

15 


OPEN 

EQU 

X'10' 

DCB OPEN FLAG 

DCBOFLGS 

EQU 

X'30' 

OPEN FLAGS OFFSETF 

WORD 

EQU 

4 

OFFSET 


SPACE 

2 


* 

CCB BYTE 0 



SPACE 



CCBFMH 

EQU 

X* 01* 

FORMATTED HEADER 

CCBDISC 

EQU 

X’ 08 * 

DISCONNECT 


SPACE 

2 


* 

CCB BYTE 1 



SPACE 



CCBEB 

EQU 

x'or 

WRITE LAST SPECIFIED 

CCBCD 

EQU 

X^O' 

WRITE WITH READ SPECIFIED 


SPACE 

2 


FMHLEN 

EQU 

0 

BYTE 0 OF FMH 

FMHTYPE 

EQU 

1 

BYTE 1 OF FMH 

FMHSEL 

EQU 

2 

BYTE 2 OF FMH 

FMHSTCK 

EQU 

3 

BYTE 3 OF FMH 

FMHPROP 

EQU 

4 

BYTE 4 OF FMH 

FMHTYP1 

EQU 

X’Ol" 

TYPE 1 FMH 

FMHBDS 

EQU 

X* 40 * 

BEGIN DATASET FMH 

FMHEDS 

EQU 

X’20* 

END DATASET FMH 

PRFSTAT1 

EQU 

X" 14 f 

STATUS BYTE OFFSET 

PRFNLSTN 

EQU 

X ,f 02 * 

NOT LAST INDICATOR 

ZERO 

EQU 

0 


ONE 

EQU 

1 


TWO 

EQU 

2 


FOUR 

EQU 

4 


***************************** **************************************** 

* 

SNACTL OPTION FIELD USAGE 


SNARCD 

EQU 

X'01* 

REMEMBER TO SET CD 

SNASCD 

EQU 

X* 02 * 

CD HAS BEEN SENT TCAM CANNOT 

* 



SEND ANY DATA 

SNASDS 

EQU 

X* 04 * 

SEND DATASET STATE 

SNARDS 

EQU 

X*08* 

RECEIVE DATASET STATE 

SNALUT2 

EQU 

X* 80' 

TYPE 2 LU THE 3270 DSE 

********************************************************************* 


EJECT 




INTRO 

PROGID=CICSTCAM f 




UNITSZ=160, 

BUFFER UNIT SIZE 



LNUNITS=100, 

SEE TCAM SYSTEM PGMER*S GUIDE 



BRACKET 3 YES, 

INCLUDE BRACKET STATE MANAGER 



BTRACE=500, 

PIU TRACE ENTRIES 



CIB=5, 

MAX 5 ACTIVE OPERATOR COMMANDS 



COMWRTE 3 YES , 

INCLUDE SERVICE AID WRITER 



CONTROL=OPCTL, 

ALLOW COMMANDS FROM OTHERS 



CPB=20, 

ACTIVE DISK CHANNEL PROGRAMS 



DISK=YES f 

DISK MESSAGE QUEUES 



DLQ=0, 

NO DEAD LETTER QUEUE 



DTRACE=500, 

DISPATCHER TRACE ENTRIES 



FEATURE 3 (NODIAL,N02741, 

,,ONLY37 0 5,ONLYSNA), 



MSUNITS=100, 

BUFFER UNITS FOR CORE QUEUE 



MAXSUBA=3, 

OBTAIN FROM NCP GENERATION 



PLCBNO=2 0, 

PSEUDO LCBS NEEDED FOR I/O 



PRIMARY 3 SYSCON, 

OPERATOR CONTROL CONSOLE 



SIBCNT=25, 

MAXIMUM SNA SESSIONS PERMITTED 



SUBAREA 3 1 

OBTAIN FROM NCP GENERATION 


LTR 

RRETURN,RRETURN 

WAS INTRO SUCCESSFUL 


BZ 

OKINTRO 

IF SO, CARRY ON 


STH 

RRETURN,DEBUG 

MAKE RETURN CODE VISIBLE 
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ABEND 4095,DUMP 

OKINTRO OPEN (MSGQUEUE, (INOUT)) 

LA RDCB,MSGQUEUE 
TM DCBOFLGSC RDCB),OPEN 
BO OKOPENQS 
ABEND 4094,DUMP 

OKOPENQS OPEN (NCP1DCB,(INOUT)> 

LA RDCB,NCP1DCB 
TM DCBOFLGS(RDCB),OPEN 
BO OKOPENO 5 
ABEND 4093,DUMP 

OKOPENO5 READY 

CLOSE (NCP1DCB,,MSGQUEUE,) 

RETURN (14,12) 

EJECT 

********* ******* ***4141***# ********************************************** 


OTHERWISE, PUNT WITH X’FFF" 

OPEN MESSAGE QUEUES DATA SET 

POINT TO DCB 

WAS OPEN SUCCESSFUL 

IF SO, CARRY ON 

OTHERWISE, PUNT WITH X'FFE" 

OPEN 3705 FOR COMMUNICATIONS 

POINT TO 3705 DCB 

WAS OPEN SUCCESSFUL 

IF SO, CARRY ON 

OTHERWISE, PUNT WITH X’FFD* 

LET TCAM START TRAFFIC 

RELINQUISH CONTROL 


* 

* 

********* 


DEFINE THE CONFIGURATION OF THE NETWORK - PHYSICAL AND LOGICAL 

************************************************************** 

SPACE 2 


DEBUG 

MSGQUEUE 


DS 

DC 

DS 

DC 

DCB 


RETURN CODE = 


NCP1DCB DCB 


CICSPCB PCB 


0D 

C* 

H 

C* * 

DSORG=TQ, 

DDNAME=MSGQUEUE, 

MACRF=(G,P>, 

OPTCD=R 
DSORG=TR, 

DDNAME=DDNCP1, 

MACRF=(G,P) 

MH=AMH,BUFSIZE=2 00 0 
TTABLE LAST-SSCP 
SNACTL OPTION XL1 
NCP1 TERMINAL DCB=NCP1DCB, 

TERM=LNCP,IPLTXID=NCP1TXT 
GRP1 GROUP MH=CICS,BUFSIZE=288, I 

OPACING=2 

LI TERMINAL TERM=LINE, 

GROUP=GRPl, 

RLN=1, 

ACTIVE=YES 

PU1 TERMINAL TERM=PUNT 

PlTl TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(80) 

P1T2 TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=l,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(80) 

P1T3 TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(80) 

P1T4 TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=l,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(00) 

SPACE 2 

PU2 TERMINAL TERM=PUNT SECOND 3790 ON THE SAME LINE 

P2T1 TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=l,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(80) 

P2T2 TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=l,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(00) 

L2 TERMINAL TERM=LINE,GROUP=GRPl,RLN=2 

PU3 TERMINAL TERM=PUNT FIRST 3767 

P3T1 TERMINAL TERM=LUNT,GROUP=GRPl,QBY=T,QUEUES=MR,RLN=2, 

TCMSESN=LUINIT,OPDATA=(00) 


TRIGGER FOR DUMP SCANNING 
TO CONTAIN INTRO RETURN CODE 
SPACING AROUND MESSAGE 
MESSAGE QUEUE DATA SET 


REUSABLE DISK QUEUES 

3705 COMMUNICATIONS CONTROLLER 


APPLICATION PROGRAM MH 
TERMINAL TABLE START AND END 

POINT TO PROPER 3705 

r 

POINT TO DEVICE MESSAGE HANDLER 
DEFINE HOST PACING 
DEFINE FIRST SDLC LINE 
POINT TO PROPER GROUP 
FIRST LINE 
ACTIVATE LINE AUTOMATICALLY 
3790 PHYSICAL UNIT - 
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PU4 TERMINAL TERM=PUNT,ACTIVE=YES FIRST 3770 

P4T1 TERMINAL TERM=LUNT,GROUP=GRPl,QBY=T,QUEUES=MR,RLN=2 , X 

TCMSESN=LUINIT,OPDATA=(00) 

CLNE TPROCESS PCB=CICSPCB, POINT TO PROCESS CONTROL BLOCK * 

ALTDEST=CLNE, REROUTE BACK AT QUEUE CLEAN-UP * 

QUEUES=MR 

TLNE TPROCESS PCB=CICSPCB 

SSCP TERMINAL TERM=SSCP 

EJECT 

* **** **************** ********************** ************** ********** 

♦ 

* SYSTEM SERVICES CONTROL POINT MESSAGE HANDLER 

* 

%*** 4c *************************** I************************************** 

IEDMHGEN SSCP=YES,TOTE=NO INVOKE IBM-SUPPLIED SSCP MH 
EJECT 


4t 4c4c *4c* + * 4c ********* * * *************** **4c4c*4c****4c**********4<* ************* 
* 

♦ DEVICE MESSAGE HANDLER 

* 

4c 4c 4c 4c* *************** **** * * * ******** ********** 4c * ******************** * *** 

CICS STARTMH LC=OUT,DFC=FULL,LU=YES 

SPACE 3 

*****************************************4(***************************** 

* 

* INPUT MESSAGE HANDLER 

* 

4c ****** ** *** * ** * ********* ***************** ***** ***************** ******* 


INHDR 
SETSCAN 0 

LTR RRETURN, RRETURN 

BM INMSG 

LA RSCAN, ONE(RRETURN) 

IEDRH RHIND=(+DFC) 

LTR RRETURN,RRETURN 

BNZ NOTDFC 

IEDRH RHIND=(+EXR) 

LTR RRETURN ,RRETURN 

BNZ NOTEXRl 

SETSCAN 4 

LA RSCAN,FOUR(RSCAN) 

NOTEXRl EQU * 

MSGTYPE X*C9* 

IEDRELS 

IEDRH BSTATE=YES 

N RRETURN,RTRMASK 

CLM RRETURN,4,PBETB 

BE NOHOLD 

CLM RRETURN,4,BETB 

BE NOHOLD 

LOCOPT SNACTL 

TM Z ERO(RRETURN),SNASCD 

BO NOHOLD 

01 ZERO(RRETURN), SNASCD 

TERRSET 

HOLD 

NOHOLD EQU * 

MSGTYPE X f 04* 

IEDRELS 

CLC ONE(TWO , RSCAN),SENS1 

BE NOHALT 


RETURN ADDRESS OF DATA 

ZERO LENGTH BUFFER 

BRANCH IF YES 

SET SCAN POINTER 

GET RH 

DFC COMMAND 

BRANCH IF NO 

GET RH 

EXCEPTION REQUEST 
BRANCH IF NO 
POINT TO COMMAND BYTE 
UPDATE SCAN POINTER 

SIGNAL COMMAND 

START OUTPUT 

GET THE BRACKET STATE 

TURN OFF RTR STATE 

PENDING BETB 

BRANCH IF YES 

BETB 

BRANCH IF YES 
GET OPTION FIELD 
CD ALREADY SENT 
BRANCH IF YES 
SET CD SENT 
SET USER ERROR BIT 
PREVENT OUTPUT 

LUSTAT COMMAND 
START OUTPUT 
COMPONENT AVAILABLE 
BRANCH IF YES 
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* 

NOHALT 

NOTDFC 


NOTINB 


SCANSET 
NOTEDS 
NOTFMH 
INBUF 


JUSTREL 

NOTCD 

INMSG 

INMSG1 


CLC ONE(TWO,RSCAN),SENS2 NO DATA TO XMIT 

BE NOHALT BRANCH IF YES 

LOCOPT SNACTL GET OPTION FIELD 

NI ZERO(RRETURN),255-(SNASCD+SNASDS) 


IEDHALT 
EQU * 

MSGTYPE X'd* 

HOLD 

MSGTYPE , 

B INBUF 

EJECT 
EQU * 

IEDRH BSTATE=YES 

N RRETURN,RTRMASK 

CLM RRETURN,4,BETB 

BE NOTINB 

CLM RRETURN,4,PBETB 

BE NOTINB 

LOCOPT SNACTL 
01 Z ERO(RRETURN),SNASCD 

EQU * 

IEDRH RHIND=(+EXR) 

LTR RRETURN,RRETURN 

BZ INMSG 

CLI ZERO(RSCAN), ZERO 

BE INBUF 

LR RSCANSVE,RSCAN 

MSGEDIT ((I ,XL2'* 0000 1 ) ) 

LA RSCAN,TWO(RSCAN) 

IEDRH RHIND=(+FMH) 

LTR RRETURN,RRETURN 

BNZ NOTFMH 

TM FMHTYPE(RSCAN),FMHTYPl 

BZ NOTBDS 

TM FMHSEL(RSCAN),FMHBDS 

BZ NOTBDS 

IC RWORK,FMHLENCRSCAN) 

STC RWORK # SCANSET+7 

SETSCAN 1,BLANK=NO 
MSGEDIT ( (I ,C ! * BTCH* ) ) 

EQU * 

OI ZERO(RSCANSVE),CCBFMH 

EQU * 

FORWARD DEST= C *CLNE• 

INBUF 

IEDRH RHIND-(+CHNGDIR,+EB) 

CLM RRETURN,1,RETCD8 

BE NOTCD 

LOCOPT SNACTL 
NI ZERO(RRETURN),255-SNASCD 

TM ZERO(RRETURN),SNALUT2 

BZ JUSTREL 

TERRSET 
EQU * 

IEDRELS 
EQU * 

INMSG PATH=(SNACTL,X*80 1 ) 
CANCELMG X*00060577FF’ 

IEDHALT X* 00060577FF' 

MSGGEN X* 0000080000',LUT2MSG 
INMSG 


RESET STATES 


SHUTDOWN COMPLETE COMMAND 
STOP OUTPUT 
ALL OTHER DFC 
NO PROCESSING TO DO 


GET BRACKET STATE 

TURN OFF RTR STATE 

BETWEEN BRACKETS 

BRANCH IF YES 

PENDING BETWEEN BRACKETS 

BRANCH IF YES 

GET OPTION FIELD 

SET CHANGE DIRECTION STATE 

GET RH 

EXCEPTION REQUEST 

BRANCH IF YES 

NULL RU 

BRANCH IF YES 

SAVE THE SCAN POINTER 

INSERT NO FMH CCB 

POINT TO START OF FMH 

GET RH 

FMH PRESENT 

BRANCH IF NO 

TYPE 1 FMH 

BRANCH IF NO 

BEGIN OF DATASET 

BRANCH IF NO 

GET FMH LENGTH 

SET AMOUNT FOR SETSCAN 

SCAN PAST FMH 

EDIT IN BATCH TRANSACTION NAME 
INDICATE FMH PRESENT 
SEND MESSAGE TO CICS 
GET RH 

CD OR EB PRESENT 
BRANCH IF NO 
GET OPTION FIELD 
RESET CD SENT 
LU TYPE 2 
BRANCH IF NO 
SEND UNLOCK MSGGEN 

START OUTPUT 

LU TYPE 2 INMSG 
CANCEL ON AN ERROR 
END THE SESSION 
RH=X*038040* 

ALL OTHER LU INMSG 
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CANCELMG X *00060577FF* CANCEL ON AN ERROR 

IEDHALT X 1 00060577FF* END THE SESSION 

MSGGEN X’0000080000 * # RH=X f 038020 * 

INEND 

EJECT 

***********************^t******************************************** 
♦ 

* OUTPUT MH 

♦ 

*********************** ************** ******************************** 


NOTBDS1 


NOFMH 


CHKEB 


REMCCB 


SPACE 3 
OUTHDR 
SETSCAN 0 

LTR RRETURN,RRETURN 
BP NOTZERO 

IEDSENSE AREA=(4) 

CLM RWORK,8,TEMPERR 

BE OUTMSG 

LOCOPT SNACTL 


TEST FOR DATA IN BUFFER 
ZERO LENGTH BUFFER 
BRANCH IF NO 
GET THE SNA SENSE 
RECOVERABLE ERROR 
BRANCH IF YES 
GET OPTION FIELD 


ZERO(RRETURN),255-(SNASDS+SNASCD) 

RESET STATES 

OUTMSG BRANCH 


NOTZERO 


LA RSCAN,ONE(RRETURN) 

TM ZERO(RSCAN),CCBFMH 

BZ NOFMH 

IEDRH RHIND=(+FMH) 

LOCOPT SNACTL 


TM FMHTYPE(RSCAN) f FMHTYP1 TYPE 1 FMH 

BZ NOFMH BRANCH IF NO 

TM FMHSELC RSCAN),FMHBDS BEGIN OF DATASET 

BZ NOTBDSl BRANCH IF NO 

OI ZERO(RRETURN),SNASDS SET IN DATA SET 

EQU * 

TM FMHSEL(RSCAN),FMHEDS END OF DATASET 

BZ NOFMH BRANCH IF NO 

NI ZERO(RRETURN),255-SNASDS TURN OFF IN DATASET STATE 

EQU * 

IEDRH BSTATE=YES GET BRACKET STATE 

N RRETURN,RTRMASK TURN OFF RTR STATE 

CLM RRETURN,4,BETB BETWEEN BRACKETS 

BNE CHKEB BRANCH IF NO 

IEDRH RHIND=(+BB) SET BEGIN BRACKET 

EQU * 

LOCOPT SNACTL GET OPTION FIELD 

TM ZERO(RRETURN),SNASDS IN DATASET STATE 

BO REMCCB BRANCH IF YES 

NI ZERO(RRETURN) f 255-(SNASCD+SNASDS) 

RESET STATES 

IEDRH RHIND=(+EB) SET END OF BRACKET 

EQU * 

MSGEDIT ((R,,SCAN,(2))) REMOVE CCB 

OUTBUF PATH=(SNACTL,X'01*) EXECUTE IF CD REQUIRED 

IEDRH RHIND=(+CHNGDIR) INSERT CD IN LAST OF CHAIN 

L RWORK,IEDADBUF GET CURRENT BUFFER 

TM PRFSTAT1(RWORK),PRFNLSTN LAST BUFFER IN MESSAGE 

BO OUTMSG BRANCH IF NO 

LOCOPT SNACTL GET OPTION FIELD 

NI ZERO(RRETURN),255-SNARCD RESET OPTION SWITCH 

OI ZERO(RRETURN),SNASCD SET CD SENT 

OUTMSG 

HOLD X’0004000002*,RELEASE TEMP ERROR WAIT FOR LUSTAT 


BRANCH 

SET SCAN REG 
FMH IN DATA 
BRANCH IF NO 
SET FMH PRESENT 
GET OPTION FIELD 
TYPE 1 FMH 
BRANCH IF NO 
BEGIN OF DATASET 
BRANCH IF NO 
SET IN DATA SET 


END OF DATASET 
BRANCH IF NO 


OUTMSG 


ZERO(RRETURN),255-SNASDS TURN OFF IN DATASET STATE 
* 

BSTATE=YES GET BRACKET STATE 

RRETURN,RTRMASK TURN OFF RTR STATE 

RRETURN,4,BETB BETWEEN BRACKETS 

CHKEB BRANCH IF NO 

RHIND=(+BB) SET BEGIN BRACKET 

* 

P SNACTL GET OPTION FIELD 

ZERO(RRETURN),SNASDS IN DATASET STATE 

REMCCB BRANCH IF YES 


SET END OF BRACKET 
REMOVE CCB 

EXECUTE IF CD REQUIRED 
INSERT CD IN LAST OF CHAIN 
GET CURRENT BUFFER 
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* 

* 


* 


HOLD X"0004000012*, 
HOLD X* 0004000013* , 
HOLD X'0000006000*, 
IEDHALT X*0000010600 

MSGGEN X*0000040008* 

MSGGEN X*0000040008* 


RELEASE TEMP ERROR WAIT FOR LUSTAT 
RELEASE BRACKET CONTENTION WAIT FOR EB 
INTVL=1Q RETRY AFTER WAIT 

END THE SESSION ON NON 
RECOVERABLE ERRORS 
,MSG2,RH=X* 0B8040* 

ABORT THE DATASET ON ERROR 
,C * FMH ERROR DS ABORTED*, 


RH=X* 0380C0 * 


INFORM THE OPERATOR 

OUTEND 

EJECT 


C 


*********************************************************************** 


* 


* MESSAGE HANDLER FOR CICS APPLICATION PROGRAM 

* 


*********************************************************************** 


AMH 

STARTMH 

INHDR 

FORWARD DEST—PUT 

INEND 

OUTHDR 

OUTEND 

EJECT 



LUT2MSG 

DC 

X'02F1C3* 

RESET THE KEY BOARD 


LUT1MSG 

DC 

x'oiis' 

RETURN THE CARRIAGE 



DS 

OF 

FORCE ALIGNMENT 


RTRMASK 

DC 

X *FFEFFFFF" 

MASK TO AND OFF RTR 

STATE 

BETB 

DC 

X" 00 ’ 

COMPARE FOR BETB 


PBETB 

DC 

X' 20' 

COMPARE FOR PENDING 

BETB 

SENSl 

DC 

X'OOOl' 

COMPONENT AVAILABLE 


SENS 2 

DC 

X"0002' 

NO DATA TO XMIT 


TEMPERR 

RETCD8 

DC 

DC 

X* 08* 

X"08* 

REQUEST REJECT ERRORB 

MSG1 

DC 

X"000000' 

MSG AREA 


MSG 2 

DC 

EJECT 

END 

X * O 6 O 6 OIOOOOAOOO' 

ABORT DATASET FMH 



SAMPLE 2: * DFHSPTM2 - SAMPLE TCAM MCP FOR TCAM DIRECT* 


*********************************************************************** 

* 

* 

* 

* NAME - CICS SAMPLE TCAM MESSAGE CONTROL PROGRAM AND MESSAGE HANDLERS 

* (CONTROLLED BY APPLICATION PROGRAMS) 

* 

* PURPOSE - THE PURPOSE OF THIS SAMPLE IS TO DEMONSTRATE TO THE CICS 

* USER WHAT IS REQUIRED FOR THE CREATION OF A SIMPLE CICS SNA 

* NETWORK USING TCAM. THE SAMPLE DEMONSTRATES HALF-DUPLEX 

* FLIP/FLOP MODE WITH BRACKETS. 

* 

* 

* FUNCTIONS - THE FUNCTIONS ARE AS FOLLOWS: 

* 

♦ INTRODUCTION - DEFINE THE OVERALL SYSTEM PARAMETERS, INITIALIZE 

* THE SYSTEM, AND START MESSAGE TRAFFIC. 
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* DEFINITION - DESCRIBE THE SPECIFICS OF THE NETWORK, THE MESSAGE 

* QUEUES, AND THE NECESSARY CONTROL BLOCKS. 

* 

* DEVICE MESSAGE HANDLER - INSERT THE COMMUNICATIONS CONTROL BYTES 

* AND ROUTE THE MESSAGE FOR INPUT f REMOVE THE CCB AND ROUTE 

* THE MESSAGE TO ITS PROPER DESTINATION ON OUTPUT. THE DMH IS 

* NAMED f CICS # SO THAT AN LU CAN LOGON TO "CICS*. 

* THIS MH SUPPORTS LU TYPEO, TYPEl, AND TYPE2. LU TYPE2 IS THE 

* 3270 DATA STREAM EMULATOR. THE SUPPORT IS DESIGNED TO ALLOW 

* THE TRANSACTION TO CONTROL THE LU. OTHER MODES OF OPERATION 

* ARE POSSIBLE BY USING DIFFERENT MH OPTIONS. THE LU TYPEl 

* BATCH SUPPORT ASSUMES A SINGLE TRANSACTION WILL HANDLE THE 

* BATCH INPUT. THE MH WILL EDIT THE TRANSACTION NAME INTO 

* THE FIRST CHAIN OF THE DATASET. THEREFORE IT IS NOT NECESSARY 

* TO PLACE A TRANSACTION NAME INTO THE DATASET. 

* THIS MH ASSUMES THAT THE TERMINAL WILL BE LOGICALLY TIED 

* TO A TRANSACTION FOR THE DURATION OF A BRACKET. ADDITIONAL 

* FLOW CONTROL WOULD HAVE TO BE ADDED TO HANDLE MESSAGE 

* SWITCHING OR HOST INITIATED BRACKETS. 

* 

* 

* APPLICATION MESSAGE HANDLER - ROUTE MESSAGES FROM THE INPUT QUEUE 

* TO CICS AND FROM CICS TO THE APPROPRIATE OUTPUT QUEUE. 

* 

* 

* THE SSCP MESSAGE HANDLER - UTILIZES THE IBM-SUPPLIED MH TO 

* PERFORM THE NECESSARY ROUTING AND ANALYSIS FUNCTIONS. COMPLEX 

* USER SYSTEMS MAY REQUIRE THIS TO BE MODIFIED BY THE USER. 

* 

* 

* NOTES - 

♦ 

♦ CONVENTIONS 

♦ 

* REGISTER 

* 

* REGISTER 

♦ 

* REGISTER 

♦ 

♦ REGISTER 

* 

* REGISTER 

* 

* DEFAULTS - 

* 

* MACRO DEFAULTS ARE USED WHEREVER REASONABLE 

* 

* 

* EXITS - 

* 

* NORMAL - 

* 

* RETURN TO THE OS/VS SUPERVISOR WHEN SHUTDOWN IS COMPLETE 

* 

* ERROR - 

* 

* X * FFF f - ABEND ON INTRO FAILURE 

* 

* X’FFE* - ABEND ON MESSAGE QUEUE DCB OPEN FAILURE 


2 IS USED AS THE DCB REGISTER 

3 USED AS INTERNAL LINKAGE REGISTER 

4 USED AS INTERNAL WORK REGISTER 

5 USED AS INTERNAL WORK REGISTER 

6 USED AS THE SCAN REGISTER 
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* X 1 FFD" - ABEND ON 3705 DCB OPEN FAILURE 

* 

♦ 

* 

* 


*********************************************************************** 


CICSTCAM 

CSECT 

RDCB 

EQU 2 

LINKREG 

EQU 3 

RWORK 

EQU 4 

RSCANSVE 

EQU 5 

RSCAN 

EQU 6 

RRETURN 

EQU 15 

OPEN 

EQU X"10" 

DCBOFLGS 

EQU X* 30" 

WORD 

EQU 4 

SPACE 2 

* 

CCB BYTE 0 
SPACE 

CCBFMH 

EQU X*01* 

CCBDISC 

EQU X'08' 

SPACE 2 

* 

CCB BYTE 1 

CCBEB 

EQU X'01" 

CCBCD 

EQU X'02‘ 
SPACE 2 

FMHLEN 

EQU 0 

FMHTYPE 

EQU 1 

FMHSEL 

EQU 2 

FMHSTCK 

EQU 3 

FMHPROP 

EQU 4 

FMHTYP1 

EQU X'01' 

FMHBDS 

EQU X* 40* 

PRFSTAT1 

EQU X'14* 

PRFNLSTN 

EQU X"02" 

ZERO 

EQU 0 

ONE 

EQU 1 

TWO 

EQU 2 

FOUR 

EQU 4 


DCB REGISTER 

INTERNAL LINKAGE REGISTER 
INTERNAL WORK REGISTER 
SAVED SCAN POINTER REGISTER 
SCAN POINTER REGISTER 

DCB OPEN FLAG 
OPEN FLAGS OFFSETF 
OFFSET 


FORMATTED HEADER 
DISCONNECT 


WRITE LAST SPECIFIED 
WRITE WITH READ SPECIFIED 

BYTE 0 OF FMH 
BYTE 1 OF FMH 
BYTE 2 OF FMH 
BYTE 3 OF FMH 
BYTE 4 OF FMH 
TYPE 1 FMH 
BEGIN DATASET FMH 
STATUS BYTE OFFSET 
NOT LAST INDICATOR 


********************************************************************* 


* SNACTL OPTION FIELD USAGE 


SNARCD 

EQU 

X"01* 

REMEMBER TO SET CD 

SNASCD 

EQU 

X" 02" 

CD HAS BEEN SENT, TCAM 

* 



SEND ANY DATA 

SNALUT2 

EQU 

» 

O 

00 

* 

X 

TYPE 2 LU A 3270 DSE 


********************************************************************* 
EJECT 

INTRO PROGID=CICSTCAM f 
UNITSZ=160, 

LNUNITS=100, 

BRACKET=YES, 

BTRACE=500, 

CIB=5 , 

COMWRTE= YES, 

CONTROL=OPCTL, 

CPB=20, ACTIVE DISK CHANNEL PROGRAMS 

DISK=YES, DISK MESSAGE QUEUES 

DLQ=0, NO DEAD LETTER QUEUE 

DTRACE=500, DISPATCHER TRACE ENTRIES 

FEATURE=(NODIAL,N02741 f ,,ONLY3705,ONLYSNA), 

MSUNITS=100, BUFFER UNITS FOR CORE QUEUE 


BUFFER UNIT SIZE 

SEE TCAM SYSTEM PGMER* S GUIDE 

INCLUDE BRACKET STATE MANAGER 

PIU TRACE ENTRIES 

MAX 5 ACTIVE OPERATOR COMMANDS 

INCLUDE SERVICE AID WRITER 

ALLOW COMMANDS FROM OTHERS 


CICS/VS System Programmers Reference Manual 


712 





MAXSUBA=3, 

PLCBNO=20, 

PRIMARY=SYSCON, 

SIBCNT=25, 

SUBAREA=1 

LTR RRETURN,RRETURN 
BZ OKINTRO 
STH RRETURN,DEBUG 
ABEND 4095,DUMP 

OKINTRO OPEN (MSGQUEUE,(INOUT)) 

LA RDCB,MSGQUEUE 
TM DCBOFLGS(RDCB),OPEN 
BO OKOPENQS 
ABEND 4094,DUMP 

OKOPENQS OPEN (NCPlDCB,(INOUT)) 

LA RDCB,NCPlDCB 
TM DCBOFLGS(RDCB),OPEN 
BO OKOPEN05 
ABEND 4093,DUMP 

OKOPEN05 READY 

CLOSE (NCPlDCB,,MSGQUEUE,) 
RETURN (14,12) 

EJECT 

****************** ***************** 


OBTAIN FROM NCP GENERATION 
PSEUDO LCBS NEEDED FOR I/O 
OPERATOR CONTROL CONSOLE 
MAXIMUM SNA SESSIONS PERMITTED 
OBTAIN FROM NCP GENERATION 
WAS INTRO SUCCESSFUL 
IF SO, CARRY ON 
MAKE RETURN CODE VISIBLE 
OTHERWISE, PUNT WITH X'FFF" 

OPEN MESSAGE QUEUES DATA SET 

POINT TO DCB 

WAS OPEN SUCCESSFUL 

IF SO, CARRY ON 

OTHERWISE, PUNT WITH X'FFE" 

OPEN 3705 FOR COMMUNICATIONS 

POINT TO 3705 DCB 

WAS OPEN SUCCESSFUL 

IF SO, CARRY ON 

OTHERWISE, PUNT WITH X'FFD" 

LET TCAM START TRAFFIC 

RELINQUISH CONTROL 

************************************ 


DEFINE THE CONFIGURATION OF THE NETWORK - PHYSICAL AND LOGICAI 


*********************************************************************** 

SPACE 2 
DS 0D 

DC C' RETURN CODE = V TRIGGER FOR DUMP SCANNING 

DEBUG DS H TO CONTAIN INTRO RETURN CODE 

DC C" ' SPACING AROUND MESSAGE 

MSGQUEUE DCB DSORG=TQ, MESSAGE QUEUE DATA SET 

DDNAME=MSGQUEUE, 

MACRF=(G,P), 

OPTCD=R REUSABLE DISK QUEUES 

DCB DSORG=TR, 3705 COMMUNICATIONS CONTROLLI 

DDNAME=DDNCP1, 

MACRF=(G,P) 

PCB MH=AMH,BUFSIZE=2000 APPLICATION PROGRAM MH 

TTABLE LAST=SSCP TERMINAL TABLE START AND END 

OPTION XL1 

TERMINAL DCB=NCP1DCB, POINT TO PROPER 3705 

TERM=LNCP,IPLTXID=NCP1TXT 

GROUP MH=CICS,BUFSIZE=288, POINT TO DEVICE MESSAGE HANOI 

OPACING=2 DEFINE HOST PACING 

TERMINAL TERM=LINE, DEFINE FIRST SDLC LINE 

GROUP=GRPl, POINT TO PROPER GROUP 

RLN=1, FIRST LINE 

ACTIVE=YES ACTIVATE LINE AUTOMATICALLY 

TERMINAL TERM=PUNT 3790 PHYSICAL UNIT - 

TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(80) 

TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(80) 

TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(80) 

TERMINAL GROUP=GRPl,QBY-T,QUEUES=MR,RLN=1,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(00) 

SPACE 2 

TERMINAL TERM=PUNT SECOND 3790 ON THE SAME LINE 


DEBUG 


MSGQUEUE 


NCPlDCB 


ClCSPCB 

SNACTL 

NCP1 


TRIGGER FOR DUMP SCANNING 
TO CONTAIN INTRO RETURN CODE 
SPACING AROUND MESSAGE 
MESSAGE QUEUE DATA SET 


REUSABLE DISK QUEUES 

3705 COMMUNICATIONS CONTROLLER 


APPLICATION PROGRAM MH 
TERMINAL TABLE START AND END 

POINT TO PROPER 3705 


POINT TO DEVICE MESSAGE HANDLED 
DEFINE HOST PACING 
DEFINE FIRST SDLC LINE 
POINT TO PROPER GROUP 
FIRST LINE 
ACTIVATE LINE AUTOMATICALLY 
3790 PHYSICAL UNIT - 
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P2T1 TERMINAL GROUP=GRPl f QBY=T f QUEUES=MR,RLN=1,TERM=LUNT, X 

TCMSESN=LUINIT,OPDATA=(80) 

P2T2 TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, X 

TCMSESN=LUINIT,OPDATA=(00) 

L2 TERMINAL TERM=LINE,GROUP=GRPl,RLN=2 

PU3 TERMINAL TERM=PUNT FIRST 3767 

P3T1 TERMINAL TERM=LUNT,GR0UP=GRP1,QBY=T,QUEUES=MR,RLN=2, X 

TCMSESN=LUINIT,OPDATA=(00) 

PU4 TERMINAL TERM=PUNT,ACTIVE-YES FIRST 3770 

P4T1 TERMINAL TERM=LUNT,GROUP=GRPl,QBY=T f QUEUES=MR,RLN=2 , X 

TCMSESN=LUINIT,OPDATA=(00) 

CLNE TPROCESS PCB=CICSPCB, POINT TO PROCESS CONTROL BLOCK * 

ALTDEST=CLNE, REROUTE BACK AT QUEUE CLEAN-UP * 

QUEUES=MR 

TLNE TPROCESS PCB=CICSPCB 

SSCP TERMINAL TERM=SSCP 

EJECT 

************************************************************* ********** 

* 

* SYSTEM SERVICES CONTROL POINT MESSAGE HANDLER 

* 

*********************************************************************** 

IEDMHGEN SSCP=YES r TOTE=NO INVOKE IBM-SUPPLIED SSCP MH 

EJECT 

*********************************************************************** 

* 

* DEVICE MESSAGE HANDLER 

* 

*********************************************************************** 

CICS STARTMH LC=OUT,DFC=FULL, LU=YES 

SPACE 3 

*********************************************************************** 

* 

* INPUT MESSAGE HANDLER 

* 

*********************************************************************** 

INHDR 


SETSCAN 0 

LTR RRETURN,RRETURN 

BM INMSG 

LA RSCAN # ONE(RRETURN) 

IEDRH RHIND=(+DFC) 

LTR RRETURN,RRETURN 

BNZ NOTDFC 

IEDRH RHIND=(+EXR) 

LTR RRETURN,RRETURN 

BNZ NOTEXRl 

SETSCAN 4 

LA RSCAN,FOURCRSCAN) 

NOTEXRl EQU * 

MSGTYPE X'*C9 * 

IEDRH BSTATE=YES 

N RRETURN,RTRMASK 

CLM RRETURN,4,PBETB 

BE NOHOLD 

CLM RRETURN,4,BETB 

BE NOHOLD 

LOCOPT SNACTL 

TM ZERO(RRETURN),SNASCD 

BO NOHOLD 

TM ZERO(RRETURN),SNALUT2 


RETURN ADDRESS OF DATA 

ZERO LENGTH BUFFER 

BRANCH IF YES 

SET SCAN POINTER 

GET RH 

DFC COMMAND 

BRANCH IF NO 

GET RH 

EXCEPTION REQUEST 
BRANCH IF NO 
POINT TO COMMAND BYTE 
UPDATE SCAN POINTER 

SIGNAL COMMAND 

GET THE BRACKET STATE 

TURN OFF RTR STATE 

PENDING BETB 

BRANCH IF YES 

BETB 

BRANCH IF YES 
GET OPTION FIELD 
CD ALREADY SENT 
BRANCH IF YES 
TYPE 2 LU 
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BZ 

LUTYPl 

BRANCH IF NO 


MVC 

MSG1 (L" LUT2MSG ), LUT2MSG 

SET LU TYPE 2 MESSAGE 


B 

SETERR 

BRANCH 

LUTYP1 

EQU 

* 



MVC 

MSGl(L'LUTlMSG),LUT1MSG 

SET LU TYPE 1 MESSAGE 

SETERR 

EQU 

* 



01 

Z ERO(RRETURN),SNASCD 

SET CD SENT 


TERRSET 

SET USER ERROR BIT 


HOLD 


PREVENT OUTPUT 

NOHOLD 

EQU 

* 



MSGTYPE X’04'' 

LUSTAT COMMAND 


IEDRELS 

START OUTPUT 


CLC 

ONE C TWO,RSCAN),SENSl 

COMPONET AVAILABLE 


BE 

NOHALT 

BRANCH IF YES 


CLC 

ONE(TWO,RSCAN),SENS2 

NO DATA TO XMIT 


BE 

NOHALT 

BRANCH IF YES 


IEDHALT 


NOHALT 

EQU 

* 



MSGTYPE X'Cl' 

SHUTDOWN COMPLETE COMMAND 


HOLD 


STOP OUTPUT 


MSGTYPE , 

ALL OTHER DFC 


B 

EJECT 

INBUF 

NO PROCESSING TO DO 

NOTDFC 

EQU 

♦ 



IEDRH 

RHIND=(+EXR) 

GET RH 


LTR 

RRETURN,RRETURN 

EXCEPTION REQUEST 


BZ 

INMSG 

BRANCH IF YES 


CLI 

ZERO(RSCAN),ZERO 

NULL RU 


BE 

INBUF 

BRANCH IF YES 


LR 

RSCANSVE, RSCAN 

SAVE THE SCAN POINTER 


MSGEDIT ((I,XL2'0000*)) 

INSERT NO FMH CCB 


LA 

RSCAN,TWO(RSCAN) 

POINT TO START OF FMH 


IEDRH 

RHlND=(+FMH) 

GET RH 


LTR 

RRETURN,RRETURN 

FMH PRESENT 


BNZ 

NOTFMH 

BRANCH IF NO 


TM 

FMHTYPEtRSCAN),FMHTYP1 

TYPE 1 FMH 


BZ 

NOTBDS 

BRANCH IF NO 


TM 

FMHSELCRSCAN),FMHBDS 

BEGIN OF DATASET 


BZ 

NOTBDS 

BRANCH IF NO 


IC 

RWORK,FMHLEN(RSCAN) 

GET FMH LENGTH 


STC 

RWORK,SCANSET+ 7 

SET AMOUNT FOR SETSCAN 

SCANSET 

SETSCAN 1,BLANK=NO 

SCAN PAST FMH 


MSGEDIT {(I,CBTCH’ )) 

EDIT IN BATCH TRANSACTION NAME 

NOTBDS 

EQU 

* 



OI 

ZERO (RSCANSVE) , CCBFMH 

INDICATE FMH PRESENT 

NOTFMH 

EQU 

* 



FORWARD DEST=C * CLNE * 

SEND MESSAGE TO CICS 

INBUF 

INBUF 

IEDRH 

RHIND=(+CHNGDIR) 

GET RH 


LTR 

RRETURN,RRETURN 

CD PRESENT 


BNZ 

NOTCD 

BRANCH IF NO 


LOCOPT SNACTL 

GET OPTION FIELD 


Nl 

ZERO(RRETURN),255-SNASCD 

RESET CD SENT 


IEDRELS 

START OUTPUT 

NOTCD 

EQU 

* 


INMSG 

INMSG 




CANCELMG X'00060577FF* 

CANCEL ON AN ERROR 


IEDHALT X 1 ' 00060577FF* 

END THE SESSION 


MSGGEN X'0000080000',MSGl,RH= 

=X'* 038020'* 


INEND 

EJECT 
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* ******************** *********** *************** ******* 4c % % % % 4c 4c 4c 4c ** **** 

* 

* OUTPUT MH 

* 

* * * * * ******************************** ********* * 4c 4c * * ** * * *** * * * **** * * * * 


* 

NOTDISC 

NOFMH 

CHKEB 

CHKCD 

REMCCB 


OUTMSG 

♦ 

* 


SPACE 3 
OUTHDR 
SETSCAN 0 

LTR RRETURN,RRETURN 
BM OUTMSG 
LA RSCAN,ONE(RRETURN) 

TM ZERO(RSCAN), CCBDISC 
BZ NOTDISC 
CANCELMG 
B OUTMSG 

EQU * 

TM ZERO(RSCAN),CCBFMH 

BZ NOFMH 

IEDRH RHIND=(+FMH> 

EQU * 

IEDRH BSTATE=YES 
N RRETURN,RTRMASK 

CLM RRETURN,4, BETB 
BNE CHKEB 
IEDRH RHIND=(+BB) 

EQU * 

TM ONE(RSCAN),CCBEB 
BZ CHKCD 
IEDRH RHIND=(+EB) 

LOCOPT SNACTL 

NI ZERO(RRETURN),255-SNASCD 
B REMCCB 

EQU * 

TM ONE(RSCAN), CCBCD 

BZ REMCCB 

HOLD 

LOCOPT SNACTL 

01 ZERO(RRETURN),SNARCD 
EQU * 

MSGEDIT ((R,,SCAN,(2))) 

OUTBUF PATH=(SNACTL, X* 01'*) 
IEDRH RHIND=(♦CHNGDIR) 

L RWORK,IEDADBUF 

TM PRFSTAT1(RWORK),PRFNLSTN 
BO OUTMSG 
LOCOPT SNACTL 

NI ZERO(RRETURN),255-SNARCD 
01 ZERO(RRETURN),SNASCD 
OUTMSG 

HOLD X’0004000002 1 ,RELEASE 
HOLD X'0004000012*,RELEASE 
HOLD X*0000006000*,INTVL=10 
IEDHALT X*0000009000",CONNECT= 

IEDHALT X"0000050600* 

OUTEND 

EJECT 


TEST FOR DATA IN BUFFER 
ZERO LENGTH BUFFER 
BRANCH IF YES 
SET SCAN REG 
SESSION END REQUESTED 
BRANCH IF NO 

STOP THE MESSAGE, END THE 
SESSION AND QUIT PROCESSING 

FMH IN DATA 
BRANCH IF NO 
SET FMH PRESENT 

GET BRACKET STATE 
TURN OFF RTR STATE 
BETWEEN BRACKETS 
BRANCH IF NO 
SET BEGIN BRACKET 

END OF TRANSACTION 
BRANCH IF NO 
SET END OF BRACKET 
GET OPTION FIELD 
RESET CD SENT 
GO REMOVE CCB 

INPUT FROM TERMINAL WANTED 

BRANCH IF NO 

STOP FURTHER OUTPUT 

GET OPTION FIELD 

SET PATH SWITCH TO SET CD 

REMOVE CCB 

EXECUTE IF CD REQUIRED 
INSERT CD IN LAST OF CHAIN 
GET CURRENT BUFFER 
LAST BUFFER IN MESSAGE 
BRANCH IF NO 
GET OPTION FIELD 
RESET OPTION SWITCH 
SET CD SENT 

TEMP ERROR WAIT FOR LUSTAT 
TEMP ERROR WAIT FOR LUSTAT 
RETRY AFTER WAIT 
AND 

END THE SESSION IF REQUESTED 
END THE SESSION ON NON 
RECOVERABLE ERRORS 
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*********************************************************************** 

* 

* MESSAGE HANDLER FOR CICS APPLICATION PROGRAM 

* 

*********************************************************************** 


AMH 

STARTMH 

INHDR 

FORWARD DEST=PUT 

INEND 

OUTHDR 

OUTEND 

EJECT 



LUT2MSG 

DC X'02F1C3* 

RESET THE KEY BOARD 


LUT1MSG 

DC X'OllS 1 

RETURN THE CARRIAGE 



DS OF 

FORCE ALIGNMENT 


RTRMASK 

DC X *FFEFFFFF * 

MASK TO AND OFF RTR 

STATE 

BETB 

DC X'OO’ 

COMPARE FOR BETB 


PBETB 

DC X*20* 

COMPARE FOR PENDING 

BETB 

SENS1 

DC X‘0001' 

COMPONENT AVAILABLE 
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Each page number in this index refers to the start of the paragraph containing the 
indexed item. Where more than one page reference is given, the major reference is first. 


abend 

abend/restart, TCAM 486 
codes — DFHSRT TYPE=SYSTEM/USER 225 
DFHSRT TYPE=SYSTEM/USER 225 
DOS/VS codes 226 
OS/VS codes 226 
recovery 226 
system or user codes 225 
transaction bit 353 
ABKPOPT operand 199 
abnormal termination 378,389 
ACB (see access method control block) 
access method control block (ACB) 449 
ACCMETH operand 

DFHFCT TYPE =ALTERNATE 119 
DFHFCT TYPE=DATASET 122 
DFHSG PROGRAM=TCP 69 
DFHTCT TYPE=INITIAL 235 
DFHTCT TYPE=ISLINK 243 
DFHTCT TYPE=LINE 251 
DFHTCT TYPE=TERMINAL 277 
accounting information 14 
ACCTID operand 14 
action bits, TACLE 352 
action flag names, DFHTEP 333 
action flags set by DFHZNAC 460 
active tasks 433 
activity keypoint frequency 199 
j) activity keypointing 

DFHSG PROGRAM= KPP 60 
user 436 

address of each terminal 240 
ADRSPCE operand 99,157 

ageing limit, temporary storage data 306 
AKP operand 60 
AKPFREQ operand 199 
ALIGN operand 98,156 
alignment, trace table entries 159 
ALT — application load table (see DFHALT) 
alternate index structure 133 
alternate page size 277 
alternate screen size 239,278 
alternative printer 277 
ALTPGE operand 277 
ALTPRT operand 290 
ALTSCRN operand 239,278 
AMXT operand 199 
ANS COBOL compilers 63 
answering list 257 
ANSWRBK operand 70,254 
anticipatory paging 166 
anticipatory paging SVC 19,216 
ANTICPG operand 166 
appendage routine, 7770 41,270 

APPENDG operand 270 
application function timings 560 
application load table (see DFHALT) 
application programming, journal control 
closing journal data sets — DFHJC 
TYPE=CLOSE 400 

1 opening journal data sets — DFHJC 
f TYPE=OPEN 397 


application programming, journal control(continue* 
reading journal data sets — DFHJC 
TYPE=GET 401 
APPLID operand 
DFHSIT 200 

DFHTCT TYPE=INITIAL 235 
VTAM 449 

ARGTYP operand 137 
argument type 137 
ASMBLR operand 15 
assembler programs 

LANG operand 47,52 
PGMLANG operand 188 
asynchronous transaction processing 
CRDR exit routine 518 
CWTR exit routine 519 
program (see DFHSG PROGRAM=ATP) 23 
user exits 517 

ATP — asynchronous transaction processing 
program (see DFHSG PROGRAM=ATP) 

ATP operand 200 
ATPMB operand 200 
ATPMT operand 200 
audible alarm feature 284 
AUTOJRN operand 50,56 
automatic 

answering feature 256 
calling feature 256 
journaling 50,56 

logical units 170 
logging 57,394 

to system log 129 
logon 282 

polling feature 256 
statistics 38,42 
task/transaction initiation 
(ATI) 71,463 
automatic journaling 170 
automatically initiated BASE 
transactions 555 
autopoll feature 268 
AUTOTRN operand 71 
AUX operand 84,85 
auxiliary storage 85 
average service time, disks 605 


background pathlengths 568 
background processor utilization 557 
BASE operand 133 
BASE transaction timings 559 
basic function, DFHSG PROGRAM=BFP 25 
basic mapping support program (see DFHSG 
PROGRAM=BMS) 

batch data interchange program (see DFHSG 
PROGRAM=DIP) 

batch processing, TCAM SNA 470 
batch region communication, DFHTCT 
TYPE=IRCBCH 242 
BDAM reference set 590 

BFP, built-in functions program (see DFHSG 
PROGRAM= BFP) 
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binary synchronous communication 
BSCODE operand 71,254,265 
CONFIG operand 266 
DFHTCT TYPE=LINE 250 
line configuration 266 
BLKKEYL operand 124 
BLKSIZE operand 

DFHDCT TYPE=SDSCI 109 
DFHFCT T YPE= DATASET 124 
DFHTCT TYPE=SDSCI 265 
block size 239,265 
block size, restart data set 61 
blocking factor 133 
BMS 

BMSFEAT operand 278 
device-dependent mapsets 28,188 
DFHSG PROGRAM^ BMS 26 
diagnostics 29 
logical units 465 
map use count 191 
mapset suffixes 188 
operand of DFHSIT 201 
page building routines 31 
page commands of DFHSIT 208 
page-retrieval command 208 
pageout routines 31 
printer support 31 
program (see DFHSG PROGRAM=BMS) 
purge routines 31 
system generation 26 
text building routines 32 
BMS — basic mapping support program 
(DFHSG PROGRAM=BMS) 

BMS features 278 
BMSCPYC operand 27 
BMSDDS operand 27 
BMSDEV operand 28,465 
BMSDIAG operand 29 
BMSDRT operand 30 
BMSFEAT operand 278 
BMSFMP operand 30 
BMSFRL operand 30 
BMSMBD operand 30 
BMSNL operand 30 
BMSOBF operand 31 
BMSPB operand 31 
BMSPGO operand 31 
BMSPRG operand 31 
BMSPROP operand 31 
BMSRCVR operand 32 
BMSSMI operand 32 
BMSTAB operand 32 
BMSTXB operand 32 
BRACKET operand 279 
bracket protocol 279 
BSCODE operand 

DFHSG PROGRAM= TCP 71 
DFHTCT TYPE==LINE 254 
DFHTCT TYPE=SDSCI 265 
BTAM 

BTAMDEV operand 72 

BTAMRLN operand 255 

define-terminal-list macro 257 

device types 72,263 

DFTRMLST macro 293 

expanded ID verification 254 

module names 236 


BTAM (continued) 

multiprocessor recovery procedures 438 

print feature 285 

reference set 588 

relative line number 255 

storage requirements 588 

terminal address 293 

terminal errors 

terminal abnormal condition 
program 325 

terminal control program 325 
terminal error program 325 
BTAMDEV operand 72 
BTAMRLN operand 255 
buffer 

BUFSIZE operand 149 
BUFSUV operand 149,396 
depletion, 3600 BSC 506 
dynamic 202 

expansion feature (2980) 285 

factors in selecting size 395 
maximum size 395 
minimum size 395 
operand 279 
pool size 216 
receive feature 256 
shift-up value 149,395 
size 394 
sizes 279 
BUFFER operand 453 
buffers 

BUFFER operand 

DFHTCT TYPE=TERMINAL 279 
BUFFERS operand 

DFHFCT TYPE=SHRCTL 144 
BUFND operand 

DFHFCT TYPE=ALTERNATE 120 
DFHFCT TYPE=DATASET 125 
BUFNI operand 

DFHFCT TYPE=DATASET 125 
BUFNO operand 

DFHDCT TYPE=SDSCI 109 
BUFSP operand 

DFHFCT TYPE=DATASET 125 
BUFND operand 120,125 
BUFNI operand 120,125 
BUFNO operand 109 
BUFPL operand 216 
BUFSIZE operand 149 
BUFSP operand 125 
BUFSUV operand 149,396 
built-in functions program (see DFHSG 
PROGRAM=BFP) 

BUILTIN operand 25 


CAA operand 41 

calculate disk device service times 
data transfer time 599 
rotational position sensing 600 
seek time 599 

calculate transaction processor 
utilizations 

relative power factors 557 
chain assembly 73,281 
changing status of logical unit 527 
channel reconfiguration hardware (CRH) 438 
CHECK operand 542 
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checking feature 
VRC/LRC 256 

checking outcome of DFHTC operation 527 
CHNASSY operand 

DFHSG PROGRAM=TCP 73 
DFHTCT TYPE=TERMINAL 281 
logical units 452 
CICS/OS/VS/TCAM interface 
TCAM 470 
TCAM SNA 46 8 
CICS/VS 

dynamic storage area 578 
function timings 559 
management programs 11 
module sizes 570 
performance aspects 551 
reference set 591 
service programs 11 
system generation 12 
system tables 97 
table sizes 575 

user exits for management programs 511 
utility program 11 
CICSDMP operand 44 
CICSSVC operand 19,216 
CLASS operand 

DFHALT TYPE=ENTRY 98 
DFHPCT TYPE=ENTRY 167 
DFHSG TYPE=INITIAL 22 
DFHTCT TYPE=LINE 255 
DFHTCT TYPE=TERMINAL 281 
closing data sets — DFHOC TYPE=CLOSE 545 
closing journal data sets — DFHJC 
TYPE=CLOSE 400 
CMPT60L operand 7 3 
CMXT operand 201 
COBOL 

compilers 63 
operand 63 
programs 

LANG operand 47,52 
PGMLANG operand 188 
code compatibility 

non-compatible interfaces 6 
object compatible interfaces 5 
source compatible interfaces 6 
CODE operand 

DFHSNEP TYPE=ERRPROC 371 
DFHTEPM TYPE=ERRPROC 340 
DFHTEPT TYPE=BUCKET 346 
DFHTEPT TYPE=PERMCODE/ERRCODE 344 
coding macro instructions 11 
command language translator program 
(see DFHSG PROGRAM=EXP) 47 
COMMAND operand 534 

command option (logical units), DFHTC 
CTYPE=COMMAND 534 
committed output message 423 
common subroutine vector table 363,373 
common subroutines, DFHTEP 331 
common system system area (see DFHSG 
PROGRAM=CSA 
common work area 36 

communicate with batch regions — DFHTCT 
TYPE=IRCBCH 

DL/I shared data base support 242 
communication control byte(s) 468,480 


communication lines — DFHTCT TYPE=LINE 
TCAM SNA devices 262 

terminal control table line entry 250 
COMPAT operand 

DFHPCT TYPE=ENTRY 168 
DFHSG PROGRAM= BMS 33 
DFHSG PROGRAM=TCP 74 
DFHTCT TYPE= TERMINAL 281 
CONDCD operand 22 
CONFIG operand 266 
configurator 
DFHFCT 117 
DFHTCT 228 

CONNECT=AUTO ope rand 282,450 
control block and area prefix fields 6 
control system dummy group (see DFHSG 
PROGRAM=CSD) 

control system operational group (see 
DFHSG PROGRAM=CSO) 

control system service group (see DFHSG 
PROGRAM=CSS) 

control system utility group (see DFHSG 
PROGRAM—CSU) 

control unit address 239 
conversational ECHO transactions 555 
conversational transactions 591 
CONVTAB operand 74,255 
copy feature 284 

count limits, default threshold 344 
COUNT operand 344,368 

CRDR exit routine, input processor (ATP) 
creating system or user abend exit 
selective transaction abend 389 
TCAPCARO field 389 
creating task abend exit 382 
cross-index data set record — DFHFCT 
TYPE=INDACC 136 
cross-reference table 669 
CS=NO operand 366 

CSA — common system area (see DFHSG 
PROGRAM=CSA) 

CSA operand 201 

CSD, control system dummy (see DFHSG 
PROGRAM=CSD) 

CSO, control system operational (see DFHSG 
PROGRAM=CSO) 

CSS, control system service group (see 
DFHSG PROGRAM=CSS) 

CSU, control system utility group (see 
DFHSG PROGRAM=CSU) 

CTLCHAR operand 111 
CTYPE macros, DFHTC 
CTYPE=CHECK 532 
TYPE=COMMAND 534 
TYPE=LOCATE 527 
TYPE=STATUS 529 
CTYPE=CHECK operand 533 
CTYPE=COMMAND operand 534 
CTYPE=LOCATE operand 528 
CTYPE=STATUS operand 530 
CU operand 267 
CUADDR operand 239 
CUFEAT operand 239 
CUPOSN operand 239 
CWTR exit routine, output processor 
(ATP) 519 
cylinder 

index area 127 
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cylinder (continued) 
overflow records 132 
CYLOFL operand 132 


DASD 

seek times 602 
timing data 600 
data base backout, DFHTBP 421 
data base description block CDBD) 
operand 319 
data buffers 125 

data definition (DD) statement 270 
data format, TCAM 472 
data management block (DMB) 217 
DATA operand 120,134 
data set 

control blocks 108 
control information — DFHDCT 
TYPE=SDSCI 108 
control information — DFHTCT 
TYPE=SDSCI 262 
control name 256,264 
definition, DFHFCT TYPE-DATASET 120 
duplicate 137 

nonresident extrapartition 112 
recovery 417 
data transfer time 599 
data written to system log 423 
DATAID operand 306,307 
DATASET operand 

DFHFCT TYPE =ALTERNATE 119 
DFHFCT TYPE=DATASET 121 
DFHFCT TYPE= REMOTE 139 
DFHOC TYPE=CLOSE 545 
DFHOC TYPE=OPEN 541 
DATASET=DUMP operand 546 
DATFORM operand 36,202 
DBD operand 319 
DBP operand 202 

DBP, dynamic backout program (see DFHSG 
PROGRAM=DBP) 

DBUFSZ operand 202 
DCB information 262 

DCP — dump control program (see DFHSG 
PROGRAM= DC P) 

DCP operand 202 

DCT — destination control table (see 
DFHDCT) 

DCT operand 202 
DD card correlation 471 
DDIR operand 217 
DDNAME operand 270 
deadlock timeout value 169 
DEBCHK operand 19 
deblocking technique 137 
DECB 

information 333 
operand 333 
default 

actions taken by DFHTACP 
DFHTEP 677 
TCAM 480 

data base backout 421 
load order (DFHNLT) 152 
page size 287 

threshold count limits 344,346 
transaction-class routine 370 


default (continued) 

3270 screen size 283 
DEFAULT operand 370 
define terminal error blocks — 

DFHTEPT 343 

defining transactions and transaction rates 
automatically initiated BASE 
transactions 555 

conversational ECHO transactions 555 
ECHO transactions 555 
transaction types 555 
DEFSCRN operand 283 
derivation of input data 

average service time, disks 605 
DESTFAC operand 105 
DESTID operand 103 

DFHDCT TYPE=INDIRECT 104 
DFHDCT TYPE=INTRA 105 
DFHDCT TYPE=REMOTE 107 
destination control table (see DFHDCT) 
destination identification (DESTID) 103 
destination identification (DSETID) 542 
destination selection 246 
DESTRCV operand 82,105 
DEVADDR operand 

DFHDCT TYPE^SDSCI 111 
DFHJCT TYPE=ENTRY 150 
DFHSG PROGRAM=DCP 45 
DFHSG PROGRAM= TRP 8 5 
DFHTCT TYPE=SDSCI 267 
device 

classification 255,281 
message handler (DMH) 468 
message handler control 468 
types 

BTAM 72 
VTAM 79 
DEVICE operand 

DFHDCT TYPE=INITIAL 102 
DFHDCT TYPE=SDSCI 111 
DFHFCT TYPE=DATASET 132 
DFHSG PROGRAM=DCP 45 
DFHSG PROGRAM=KPP 61 
DFHSG PROGRAM=TCP 75 
DFHSG PROGRAM=TRP 85 
DFHSG TYPE=INITIAL 19 
DFHTCT TYPE=SDSCI 263 
device-dependent mapset suffixes 
DFHALT 

control section — DFHALT 
TYPE=INITIAL 97 

end of application load table — DFHALT 
TYPE=FINAL 99 

program load sequence — DFHALT 
TYPE=ENTRY 97 
DFHALT TYPE=ENTRY 

ADRSPCE operand 99 
ALIGN operand 98 
CLASS operand 98 
FIX operand 98 
page alignment 98 
page fixing 99 
PAGEOUT operand 99 
PROGRAM operand 98 
TYPE=ENTRY operand 98 
DFHALT TYPE=FINAL 

TYPE=FINAL operand 99 
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DFHALT TYPE=INITIAL 
SUFFIX operand 97 
s TYPE=INITIAL operand 97 

) DFHBIF TYPE=PHONETIC 547 
DFHDCT 

control section — DFHDCT 
TYPE=INITIAL 101 

data set control information — DFHDCT 
TYPE=SDSCI 108 

end of destination control table — 
DFHDCT TYPE=FINAL 111 
examples 112 

extrapartition destinations — DFHDCT 
TYPE=EXTRA 102 

indirect data destinations — DFHDCT 
TYPE=INDIRECT 104 

intrapartition destinations — DFHDCT 
TYPE=INTRA 104 

nonresident extrapartition data 
sets 112 

remote transient data destinations — 
DFHDCT TYPE=REMOTE 107 
required entries 621 
trigger level 100 
DFHDCT TYPE=EXTRA 

DESTID operand 103 
DSCNAME operand 103 
OPEN operand 103 
RESIDNT operand 104 
TYPE=EXTRA operand 103 
DFHDCT TYPE=FINAL 

TYPE=FINAL operand 112 
DFHDCT TYPE-INDIRECT 
DESTID operand 104 
* INDDEST operand 104 

/ TYPE=INDIRECT operand 104 

DFHDCT TYPE=INITIAL 
DEVICE operand 102 
INDEX operand 101 
SEPASMB operand 101 
SUFFIX operand 102 
TRNSUFX operand 102 
TYPE=INITIAL operand 101 
DFHDCT TYPE=INTRA 

DESTFAC operand 105 
DESTID operand 105 
DESTRCV operand 105 
enqueue lockout 105 

logically recoverable destinations 106 
physically recoverable destinations 105 
REUSE operand 106 
TRANSID operand 106 
trigger level 107 
TRIGLEV operand 107 
TYPE=INTRA operand 105 
DFHDCT TYPE=REMOTE 

DESTID operand 107 
LENGTH operand 108 
RMTNAME operand 108 
SYSIDNT operand 108 
TYPE =REMOTE operand 107 
DFHDCT TYPE=SDSCI 

BLKSIZE operand 109 
BUFNO operand 109 
CTLCHAR operand 111 
DEVADDR operand 111 
| DEVICE operand 111 
® DSCNAME operand 109 


DFHDCT TYPE=SDSCI (continued) 

ERROPT operand 109 
FILABL operand 111 
MODNAME operand 111 
RECFORM operand 109 
RECSIZE operand 109 
REWIND operand 110 
SUFFIX operand 110 
TPMARK=NO operand 111 
TYPE=SDSCI operand 108 
TYPEFLE operand 110 
variable length records 110 
DFHFCT 

configurator 117 
control section — DFHFCT 
TYPE-INITIAL 118 

cross-index data set record — DFHFCT 
TYPE=INDACC 136 

data sets -- DFHFCT TYPE=DATASET 120 
end of file control table — DFHFCT 
TYPE=FINAL 144 
examples 145 
file management 116 
header of segmented record — DFHFCT 
T YPE=S EGHEAD .141 
last segment set — DFHFCT 
TYPE=SEGLAST 142 

remote files — DFHFCT TYPE= REMOTE 139 
segment sets — DFHFCT TYPE=SEGSET 142 
segments of segmented record — DFHFCT 
TYPE=SEGDEF 140 

superset ISAM logic module — DFHFCT 
TYPE=LOGICMOD 138 

VSAM ICIP mixed mode access -- DFHFCT 
TYPE=ALTERNATE 118 

VSAM shared resources control — DFHFCT 
TYPE=SHRCTL 143 
DFHFCT TYPE=ALTERNATE 
ACCMETH operand 119 
BUFND operand 120 
BUFNI operand 120 
DATA operand 120 
DATASET operand 119 
INDEX operand 120 
JID operand 120 
JREQ operand 120 
LOG operand 120 
PASSWD operand 120 
RECFORM operand 120 
SERVREQ operand 119 
STRNO operand 120 
STRNOG operand 120 
TYPE=ALTERNATE operand 119 
DFHFCT TYPE=DATASET 

ACCMETH operand 122 

alternate index structure 13 3 

automatic logging to system log 129 

BASE operand 133 

BLKKEYL operand 124 

BLKSIZE operand 124 

blocking factor 133 

BUFND operand 125 

BUFNI operand 125 

BUFSP operand 125 

cylinder index area 127 

cylinder overflow records 132 

CYLOFL operand 132 

DATA operand 134 
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DFHFCT TYPE=DATASET (continued) 
DATASET operand 121 
DEVICE operand 132 
EXTENT operand 133 
file service requests 123 
FILSTAT operand 126 
format of records 130 
INDAREA operand 126 
INDEX operand 134 
index skip feature 133 
INDSIZE operand 126 
INDSKIP=YES operand 133 
IOSIZE operand 127 
IOWORK operand 134 
JID operand 127 
journal file identification 127 
journaling requests 128 
JREQ operand 128 
keyfield 131 
KEYLEN operand 128 
LOG operand 129 
logical key length 128 
logical record length 129 
LRECL operand 129 
master index 133 
maximum number of extents 133 
mixed mode files (VSAM ICIP) 135 
MODE operand 135 
MSTIND=YES operand 133 
multiple track search 132 
NRECDS operand 133 
OPEN operand 130 
parity check 132 
PASSWD operand 130 
physical key length 124 
RECFORM operand 130 
relative addressing 131 
RELTYPE operand 131 
RKP operand 131 
SERVREQ operand 122 
SRCHM operand 131 
strings 132 
strings (GET only) 136 
STRNO operand 132 
STRNOG operand 136 
TYPE=DATASET operand 121 
VERIFY=YES operand 132 
VSAM buffers 125 
DFHFCT TYPE-FINAL 

TYPE=FINAL operand 145 
DFHFCT TYPE=INDACC 

ARGTYP operand 137 
argument type 137 
deblocking technique 137 
DUPDSID operand 137 
duplicate data set 137 
IADADMI operand 137 
IADIII operand 137 
IALKFL operand 136 
IARLKP operand 136 
OBJDSID operand 137 
object data set 137 
record identification field 136 
search argument type 138 
SRCHTYP operand 137 
TYPE=INDACC operand 136 
DFHFCT TYPE=INITIAL 
SUFFIX operand 118 


DFHFCT TYPE=INITIAL (continued) 

TYPE 2 *INITIAL operand 118 
DFHFCT TYPE=LOGICMOD 

rotational position sensing 139 
RPS=SVA operand 139 
TYPE=LOGICMOD operand 139 
DFHFCT TYPE=REMOTE 

DATASET operand 139 
KEYLEN operand 139 
LRECL operand 140 
RMTNAME operand 140 
SYSIDNT operand 139 
TYPE=REMOTE operand 139 
DFHFCT TYPE=SEGDEF 

SEGLENG operand 140 
segment characteristics 140 
segment length 140 
SEGNAME operand 140 
TYPE=SEGDEF operand 140 
DFHFCT TYPE=SEGHEAD 

INDDISP operand 141 
SEGLENG operand 141 
segment indicator field 141 
TSEGIND operand 141 
type of segment indicator field 141 
TYPE=SEGHEAD operand 141 
DFHFCT TYPE=SEGLAST 

TYPE=SEGLAST operand 142 
DFHFCT TYPE=SEGSET 

SEGNAME operand 143 
SEGSET operand 142 
TYPE=SEGSET operand 142 
DFHFCT TYPE=SHRCTL 

BUFFERS operand 144 
KEYLEN operand 144 
maximum key length 144 
resource limit 144 
RSCLMT operand 144 
STRNO operand 144 
TYPE=SHRCTL operand 143 
DFHJC TYPE-(GETJCA,OPEN) 415 
DFHJC TYPE-CLOSE 

IDERROR operand 400 
IOERROR operand 400 
JFILEID operand 401 
LEAVE operand 401 
NORESP operand 401 
STATERR operand 401 
TYPE=CLOSE operand 400 
DFHJC TYPE=GET 

EOFADDR operand 403 
IDERROR operand 403 
INVREQ operand 403 
IOERROR operand 403 
JFILEID operand 403 
NORESP operand 403 
NOTOPEN operand 403 
STATERR operand 403 

TYPE=GETB/GETF/NOTE/POINT operand 402 
VOLERR operand 403 
DFHJC TYPE=OPEN 

IDERROR operand 398 
INVREQ operand 398 
IOERROR operand 398 
JFILEID operand 398 
NORESP operand 398 
SIVOL=YES operand 398 
STATERR operand 399 
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DFHJC TYPE=OPEN (continued) 

TYPE=OPEN operand 397 
VOLERR operand 399 
volume error 399 
VOLUME operand 399 
DFHJCT 

control section — DFHJCT 
TYPE=INITIAL 148 

end of journal control table — DPHJCT 
TYPE=FINAL 150 
example 151 

journal entries — DFHJCT 
TYPE=ENTRY 148 
DFHJCT TYPE=ENTRY 

buffer shift-up value 149 
BUFSIZE operand 149 
BUFSUV operand 149 
DEVADDR operand 150 
JDEVICE operand 150 
JFILEID operand 149 
journal file identification 149 
journaling options 149 
JOUROPT operand 149 
JTYPE operand 149 
OPEN operand 150 
type of journal data set 149 
TYPE=ENTRY operand 148 
volume switching 149 
DFHJCT TYPE=FINAL 

TYPE=FINAL operand 151 
DFHJCT TYPE=INITIAL 
SUFFIX operand 148 
TYPE=INITIAL operand 148 
DFHKP TYPE=CHECK 

EOFADDR operand 436 
IOERROR operand 436 
NORESP operand 436 

test transaction backout response 435 
TYPE=CHECK operand 435 
DFHKP TYPE=RTBOCTL 

EOFADDR operand 434 
IOERROR operand 434 
NORESP operand 434 
read transaction backout control 
record 434 

TYPE=RTBOCTL operand 434 
DFHKP TYPE=RTBODATA 

EOFADDR operand 435 
IOERROR operand 435 
NORESP operand 435 
read transaction backout data 434 
TYPE=RTBODATA operand 435 
DFHKP TYPE=RTBOEND 

reset transaction backout pointer 435 
TYPE=RTBOEND operand 435 
DFHNLT 

control section — DFHNLT 
TYPE=INITIAL 155 
default load order 152 
end of nucleus load table — DFHNLT 
TYPE=FINAL 158 
examples 158 

module load sequence — DFHNLT 
TYPE=ENTRY 155 
trace table alignment 159 
DFHNLT TYPE=ENTRY 

ADRSPCE operand 157 
ALIGN operand 156 


DFHNLT TYPE=ENTRY (continued) 

FIX operand 156 
MODULE operand 155 
nucleus module name 156 
page alignment 156 
page fixing 156 
PAGEIN operand 157 
PAGEOUT operand 157 
TYPE=ENTRY operand 155 
DFHNLT TYPE=FINAL 

TYPE=FINAL operand 158 
DFHNLT TYPE=INITIAL 
SUFFIX operand 155 
TYPE=INITIAL operand 155 
DFHOC TYPE=CLOSE 

DATASET operand 545 
DSETID operand 545 
TYPE=CLOSE operand 545 
DFHOC TYPE=OPEN 

CHECK operand 542 
DATASET operand 541 
destination identification 542 
DSETID operand 542 
ICIP and mixed mode files 544 
LISTADR operand 543 
MODE operand 544 
SYMBADR operand 545 
TYPE=OPEN operand 541 
DFHOC TYPE=SWITCH 

DATASET=DUMP operand 546 
TYPE=SWITCH operand 545 
DFHPC TYPE=SETXIT macro 381 
DFHPCT 

control section — DFHPCT 
TYPE=INITIAL 161 

end of program control table — DFHPCT 
TYPE=FINAL 179 
examples 180 
required entries 622 
required entries — DFHPCT 
TYPE=GROUP 176 

transaction control information — 
DFHPCT TYPE=ENTRY 163 
transaction description options — 
DFHPCT TYPE=0PTGRP 178 
TWASIZE 623 
DFHPCT TYPE-ENTRY 

anticipatory paging 166 
ANTICPG operand 166 
automatic journaling 170 
automatic journaling for logical 
units 170 
CLASS operand 167 
COMPAT operand 168 
deadlock timeout feature 169 
DTB operand 168 
DTIMOUT operand 169 
DUMP operand 169 
DVSUPRT operand 169 
dynamic transaction backout 168 
FDUMP operand 169 
INBFMH operand 170 
JFILEID operand 170 
logical record presentation 170 
LOGREC operand 170 
message option group 171 
MSGJRNL operand 170 
NEPCLAS operand 171 
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DFHPCT TYPE=ENTRY (continued) 

OPTGRP operand 171 
primed storage allocation 175 
PRIVATE operand 171 
PRMSIZE operand 175 
PROGRAM operand 164 
read timeout feature 172 
RESTART operand 171 
RMTNAME operand 172 
RTIMOUT operand 172 
SCRNSZE operand 172 
SPURGE operand 173 
SYSIDNT operand 173 
system stall purge indicator 173 
TASKREQ operand 164 
TCLASS operand 173 
terminal error purge indicator 174 
TI0TYPE operand 174 
TPURGE operand 174 
transaction class 173 
transaction I/O processing 174 
transaction priority 175 
transaction restart facility 171 
transaction security key 174 
transaction work area size 175 
TRANSEC operand 174 
TRANSID operand 165 
TRNPRTY operand 175 
TRNSTAT operand 175 
TWASIZE operand 175 
TYPE=ENTRY operand 164 
XTRANID operand 175 
DFHPCT TYPE=FINAL 

TYPE=FINAL operand 180 
DFHPCT TYPE=GROUP 
FN operand 176 
functional groups 176 
required entries 622 
TYPE=GROUP operand 176 
DFHPCT TYPE=INITIAL 
DTB operand 162 
dynamic transaction backout 162 
FDUMP operand 162 
formatted dump program 162 
INDEX operand 162 
indexing 162 
SCRNSZE operand 163 
SUFFIX operand 163 
TYPE=INITIAL operand 161 
DFHPCT TYPE=OPTGRP 455 
message integrity 179 
message option groups 178 
message protection 179 
MSGPOPT operand 179 
MSGPREQ operand 179 
TYPE=OPTGRP operand 179 
DFHPLT 

control section — DFHPLT 
TYPE=INITIAL 183 

end of program list table — DFHPLT 
TYPE=FINAL 185 

entries in program list table DFHPLT 
TYPE=ENTRY 184 
example 185 
first quiesce stage 183 
post-initialization phase 182 
system initialization processing 182 


DFHPLT TYPE=ENTRY 

PROGRAM operand 184 
PROGRAM=DFHDELIM operand 184 
PROGRAM=DLZSTPOO operand 185 
TYPE=ENTRY operand 184 
DFHPLT TYPE=FINAL 

TYPE=FINAL operand 185 
DFHPLT TYPE=INITIAL 
SUFFIX operand 184 
TYPE=INITIAL operand 184 
DFHPPT 

control section — DFHPPT 
TYPE=INITIAL 186 

end of processing program table — 

DFHPPT 194 
example 194 

processing programs — DFHPPT 
TYPE=ENTRY 187 
required entries 625 
required entries — DFHPPT 
TYPE=GROUP 191 
DFHPPT TYPE=ENTRY 

BMS device-dependent mapsets 188 
forced pageout 190 
mapset suffixes 188 
PGMLANG operand 188 
PGMSTAT operand 188 
program load request 188 
PROGRAM operand 187 
RELOAD operand 188 
RES operand 189 
TYPE=ENTRY operand 187 
USAGE=MAP operand 190 
use count for BMS maps 191 
DFHPPT TYPE=FINAL 

TYPE=FINAL operand 194 
DFHPPT TYPE=GROUP 

execution diagnostic facility (EDF) 192 
FN operand 191 
functional groups 191 
required entries 625 
TYPE=GROUP operand 191 
DFHPPT TYPE=INITIAL 
INDEX operand 187 
SUFFIX operand 187 
TYPE=INITIAL operand 186 
DFHSG 

PROGRAM=ATP 23 
PROGRAM=BFP 24 
PROGRAM= BMS 26 
PROGRAM=C SA 35 
PROGRAM=CSD 36 
PROGRAM=CSO 37 
PROGRAM—CSS 41 
PROGRAM=CSU 42 
PROGRAM= DBP 42 
PROGRAM=DCP 44 
PROGRAM=DIP 45 
PROGRAM=EIP 46 
PROGRAM=EXP 47 
PROGRAM=FCP 48 
PROGRAM=GAP 51 
PROGRAM=HLL 51 
PROGRAM=ICP 53 
PROGRAM=ISC 54 
PROGRAM^J CP 55 
PROGRAM=KC P 58 
PROGRAM=KPP 59 
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DFHSG (continued) 

PROGRAM=MTP 61 
PROGRAM=OCP 62 
PROGRAM= PCP 62 
PROGRAM=RSP 64 
PROGRAM^ SCP 65 
PROGRAM= SRP 66 
PROGRAM= TBP 67 
PROGRAM= TCP 68 
PROG RAM= TDP 81 
PROGRAM=TRP 84 
PROG RAM= TS P 85 
TYPE=FINAL 87 
TYPE=INITIAL 13 
DFHSG PROGRAM=ATP 23 
INBUFF operand 24 
OUTBUFF operand 24 
PROGRAM=ATP operand 24 
STAGE2 operand 24 
DFHSG PROGRAM=BFP 24 
basic function 25 
BUILTIN operand 25 
DUMMY=YES operand 25 
PROGRAM= BFP operand 25 
STAGE2 operand 25 
SUFFIX operand 26 
weighted retrieval function 25 
DFHSG PROGRAM=BMS 26 

BMS page building routines 31 

BMSCPYC operand 27 

BMSDDS operand 27 

BMSDEV operand 28 

BMSDIAG operand 29 

BMSDRT operand 30 

BMSFMP operand 30 

BMSFRL operand 30 

BMSMBD operand 30 

BMSNL operand 30 

BMSOBF operand 31 

BMSPB operand 31 

BMSPGO operand 31 

BMSPRG operand 31 

BMSPROP operand 31 

BMSRCVR operand 32 

BMSSMI operand 32 

BMSTAB operand 32 

BMSTXB operand 32 

COMPAT operand 33 

device-dependent mapset suffixes 28 
diagnostics 29 
DUMMY=YES operand 33 
field relocation 30 
MAPALGN operand 33 
MAPHC operand 33 
MAP3270 operand 33 
outboard formatting 31 
pageout routines 31 
PAGING operand 34 
PRGDLAY= hhmm operand 34 
PROGRAM=BMS operand 27 
purge delay time interval 35 
purge routines 31 
ROUTING operand 35 
single keystroke retrieval 35 
SKR3270 operand 35 
SUFFIX operand 35 
text building routines 32 
DFHSG PROGRAM=CSA 35 


DFHSG PROGRAM=CSA (continued) 
DATFORM operand 36 
PROGRAM=CSA operand 36 
SUFFIX operand 36 
WRKAREA operand 36 
DFHSG PROGRAM= CSD 36 

PROGRAM=CSD operand 37 
STAGE2 operand 37 
DFHSG PROGRAM=CSO 37 

appendage routine, 7770 41 

automatic statistics 38 
CAA operand 41 

nonsequential disk extents 40 

NSD operand 40 

PROGRAM= CS0 operand 39 

STAGE2 operand 39 

SVC operand 41 

TCAMSIP=YES operand 41 

version 1 compatibility 41 

VlCMPAT=YES operand 41 


DFHSG PROGRAM^CSS 

41 


PROGRAM=CSS operand 

41 

STAGE2 operand 

42 


DFHSG PROGRAM^CSU 

42 


automatic statistics 

42 

PROGRAM=CSU operand 

42 

STAGE2 operand 

42 


DFHSG PROGRAM^DBP 

42 


PROGRAM-DBP operand 

43 

STAGE2 operand 

43 


SUFFIX operand 

43 


XDERROR operand 

43 


XFERROR operand 

43 


XINIT operand 43 


XINPUT operand 

43 


DFHSG PROGRAM=DCP 

44 


CICSDMP operand 

44 


DEVADDR operand 

45 


DEVICE operand 

45 



DUMMY=YES operand 44 
PROGRAM= DCP operand 44 


STAGE2 operand 

44 

SUFFIX operand 

44 

DFHSG PROGRAM=DIP 

45 

DUMMY=YES operand 45 
PROGRAM=DIP operand 45 

STAGE2 operand 

46 

SUFFIX operand 

46 

DFHSG PROGRAM=EIP 

46 

PROGRAM 3 EIP operand 46 

STAGE2 operand 

46 

DFHSG PROGRAM= EXP 

47 


LANG operand 47 
PLI/PL1-SHARE operand 48 
PLILIB operand 48 
PROGRAM=EXP operand 47 
STAGE2 operand 48 
SUFFIX operand 48 
DFHSG PROGRAM=FCP 4 8 
AUTOJRN operand 50 
automatic journaling 50 
DUMMY=YES operand 50 
FILSERV operand 49 
PROGRAM= FCP operand 49 
SUFFIX operand 50 
XINPUT operand 50 
XINPUTC operand 51 
XOUTPUT operand 51 
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DFHSG PROGRAM=FCP (continued) 

XTYPREQ operand 51 
DFHSG PROGRAM=GAP 51 

PROGRAM=GAP operand 51 
STAGE2 operand 51 
DFHSG PROGRAM=HLL 51 
LANG operand 52 
PLILIB operand 53 
PL1/PLI/PL/I operand 53 
PROGRAM=HLL operand 52 
STAGE2 operand 52 
DFHSG PROGRAM=ICP 53 

PROGRAM—ICP operand 53 
STAGE2 operand 53 
SUFFIX operand 54 
XICEEXP operand 54 
XTYPREQ operand 54 
DFHSG PROGRAM=ISC 

DL/I shared data base support 54 
inter-region communication SVC 55 
IRCSVC operand 55 
PROGRAM=ISC operand 55 
SUFFIX operand 55 
DFHSG PROGRAM=JCP 55 
AUTOJRN operand 56 
automatic journaling 56 
automatic logging 57 
DTB operand 57 
DUMMY=YES operand 57 
NOTE operand 57 
positioning information 57 
PROGRAM=JCP operand 56 
STAGE2 operand 57 
SUFFIX operand 58 
UPRFX operand 58 
user prefix creation 58 
DFHSG PROGRAM=KCP 58 
OPSECUR operand 58 
PROGRAM=KCP operand 58 
STAGE2 operand 59 
SUFFIX operand 59 
XDSPCHR operand 59 
XTYPREQ operand 59 
DFHSG PROGRAM=KPP 59 

activity keypointing 60 
AKP operand 60 

block size, restart data set 61 
DEVICE operand 61 
DUMMY=YES operand 60 
PROGRAM=KPP operand 60 


RSDBLKS operand 

61 


STAGE2 operand 

61 


SUFFIX operand 

61 


DFHSG PROGRAM=MTP 

61 


PROGRAM=MTP operand 

61 

STAGE2 operand 

62 


DFHSG PROGRAM=OCP 

62 


PROGRAM= OCP operand 

62 

STAGE2 operand 

62 


DFHSG PROGRAM=PCP 

62 


ANS COBOL compilers 

63 

COBOL compilers 

63 


COBOL operand 

63 


high-level language 

trace 

HLLTR operand 

63 



LANG operand 63 
PROGRAM=PCP operand 63 
SUFFIX operand 64 


DFHSG PROGRAM^PCP 

(continued) 

XFETCH 64 



DFHSG PROGRAM=RSP 

64 


PROGRAM=RSP operand 

64 

RESEND operand 

64 


STAGE2 operand 

65 


DFHSG PROGRAM^SCP 

65 


PROGRAM=SCP operand 

65 

RECOVER operand 

65 


STAGE2 operand 

65 


storage recovery 65 


SUFFIX operand 

66 


XTYPREQ operand 

66 


DFHSG PROGRAM= SRP 

66 


DUMMY=YES operand 66 


PROGRAM= SRP operand 

66 

STAGE2 operand 

67 


SUFFIX operand 

67 


DFHSG PROGRAM=TBP 

67 


PROGRAM=TBP operand 

67 

STAGE2 operand 

68 


XDERROR operand 

68 


XFERROR operand 

68 


XINIT operand 68 


XINPUT operand 

68 


DFHSG PROGRAM= TCP 

68 


ACCMETH operand 

69 


ANSWRBK operand 

70 



automatic transaction initiation 71 

AUTOTRN operand 71 

BSCODE operand 71 

BTAM device types 72 

BTAMDEV operand 72 

chain assembly 73 

CHNASSY operand 73 

CMPT60L operand 73 

COMPAT operand 7 4 

CONVTAB operand 74 

DEVICE operand 75 

DL/I shared data base support 70 

end-of-data indicator 75 

EODI=xx operand 75 

FEATURE operand 75 

FMT2260 operand 75 

FMT3270 operand 76 

INITRL=YES operand 81 

keyboard lock feature 76 

LOCKF=YES operand 76 

logical record presentation 76 

logical unit types 79 

LOGREC operand 76 

pipeline session 76 

PIPELN operand 76 

PROGRAM=TCP operand 69 

PUNSOL operand 77 

RAQ=YES operand 77 

read-ahead-queuing 77 

SMI operand 77 

STAGE2 operand 77 

SUFFIX operand 78 

tab feature 7 8 

TAB operand 7 8 

TBLFIX operand 7 8 

TCM3270=YES operand 81 

translate tables 78 

UCTRAN operand 78 

unsolicited input 77 

uppercase translation 78 
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DFHSG PROGRAM=TCP (continued) 
VTAMDEV operand 79 
WRAPLST operand 80 
XATTACH operand 80 
XINPUT operand 80 
XOUTPUT operand 80 
XRDATT operand 8 0 
XTCMIN operand 81 
XTCMOUT operand 81 
ZATTACH operand 80 
ZINPUT operand 81 
ZOUTPUT operand 81 
2260 compatibility 74 
DFHSG PROGRAM=TDP 81 
DESTRCV operahd 82 
DUMMY=YES operand 82 
EXTRA operand 82 
extrapartition data sets 82 
INTRA operand 82 
intrapartition data sets 82 
PR0GRAM= TDP operand 8 2 
recoverable destinations 82 
STAGE2 operand 8 3 
SUFFIX operand 83 
transient data recovery 82 
XINPUT operand 83 
XOUTPUT operand 83 
XTYPREQ operand 83 
DFHSG PROGRAM=TRP 84 
AUX operand 84 
DEVADDR operand 85 
DEVICE operand 85 
DUMMY=YES operand 84 
PROGRAM= TRP operand 84 
STAGE2 operand 84 
SUFFIX operand 84 
DFHSG PROGRAM=TSP 85 
AUX operand 85 
auxiliary storage 85 
DUMMY=YES operand 86 
PROGRAM=TSP operand 85 
STAGE2 operand 86 
SUFFIX operand 86 
XINPUT operand 86 
XOUTPUT operand 86 
XTYPREQ operand 87 
DFHSG TYPE=INITIAL 
ACCTID operand 14 
anticipatory paging SVC 19 
ASMBLR operand 15 
CICSSVC operand 19 
CLASS operand 22 
CONDCD operand 22 
DEBCHK operand 19 
DEVICE operand 19 
DLI operand 15 
EJECT operand 15 
JOBNAME operand 16 
MOD operand 16 
MSGCLAS operand 22 
MSGLVL operand 22 
OPSYS operand 19 
OS/VS JCL options 22 
page-fix SVC 19 
PGMERID operand 22 
PREFIX operand 22 
PRINT operand 17 
PRIORTY operand 22 


DFHSG TYPE=INITIAL (continued) 

PROCNMS operand 22 
REGION operand 23 
service request block SVC 20 
SMPDATE operand 20 
SMPLKED operand 20 
SMPSIZE operand 20 
SRBSVC operand 20 
STAGE2 operand 17 
starter system library 18 
STATUS=FIRST operand 21 
system modification program 20 
TCTUA operand 21 
TYPE=INITIAL operand 14 
Version 1 compatibility 21 
VSAM enhancements 22 
VSAM operand 18 
VSAM shared resources 18 
VSAME operand 21 
VSAMSHR operand 18 
VTAM operand 18 
DFHSIT 

ABKPOPT operand 199 

activity keypoint frequency 199 

AKPFREQ operand 199 

AMXT operand 199 

anticipatory paging SVC 216 

APPLID operand 200 

ATP operand 200 

ATPMB operand 200 

ATPMT operand 200 

BMS operand 201 

buffer pool size 216 

BUFPL operand 216 

CICSSVC operand 216 

CMXT operand 201 

CSA operand 201 

data management block (DMB) 217 

DATFORM operand 202 

DBP operand 202 

DBUFSZ operand 202 

DCP operand 202 

DCT operand 202 

DDIR operand 217 

DIP operand 202 

DL/I shared data base support 200,218 

DLI operand 203 

DLTHRED operand 217 

DMBPL operand 217 

DSB operand 203 

dynamic buffer size 202 

dynamic transaction backout 202 

ENQ control block space 217 

ENQPL operand 217 

EXEC operand 203 

FCP operand 203 

FCT operand 204 

FDP operand 204 

FLDSEP operand 205 

FLDSTRT operand 205 

formatted dump program 204 

F2260 operand 203 

ICP operand 205 

ICV operand 205 

ICVR operand 206 

ICVS operand 206 

ICVSWT operand 215 

ICVTSD operand 206 
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DPHSIT (continued) 

IIP operand 206 
IOCP operand 217 
IKCSTRT operand 217 
ISC operand 206 
JCP operand 206 
JCT operand 207 
KCP operand 207 
keypointing with abnormal 
termination 199 
KPP operand 207 

maximum number of active asynchronous 
tasks 201 

maximum number of active tasks 199 

MCP operand 207 

MSGLVL operand 207 

MXT operand 207 

M32 operand 207 

NLT operand 208 

NSD operand 216 

OSCOR operand 218 

page-chaining command 208 

page-copy command 208 

page-purge command 208 

PBP operand 208 

PCP operand 208 

PCT operand 208 

PDIR operand 219 

PGCHAIN operand 208 

PGCOPY operand 208 

PGRET operand 208 

PGSIZE operand 209 

PISCHD operand 220 

PLI operand 209 

PLISHRE operand 220 

PLTPI operand 209 

PLTSD operand 209 

PPT operand 210 

PRINT operand 210 

PSB operand 220 

PSB pool size 220 

PSBPL operand 220 

RLR operand 211 

SCP operand 211 

SCS operand 211 

service request block SVC 220 

SKR operand 212 

SRBSVC operand 220 

SRP operand 212 

START operand 212 

storage cushion size 212 

storage violation dump 213 

SUFFIX operand 213 

SVD operand 213 

TCP operand 213 

TCT operand 213 

TDP operand 213 

TPP operand 213 

trace table entries 214 

TRP operand 214 

TRT operand 214 

TSMGSET operand 214 

TSP operand 214 

TST operand 214 

TYPE=CSECT/DSECT operand 198 

WRKAREA operand 215 

XLT operand 215 

ZCP operand 215 


DFHSNEP TYPE-DEFILU 

TYPE=DEFILU operand 367 
DFHSNEP TYPE=DEF3 270 

TYPE=DEF3270 operand 366 
DFHSNEP TYPE= ERRPROC 
CODE operand 371 
GROUP operand 372 
TYPE=ERRPROC operand 371 
DFHSNEP TYPE=INITIAL 366 
CS=N0 operand 366 
NAME operand 366 
NETNAME operand 366 
TYPE-INITIAL operand 366 
DFHSNET macro 

COUNT operand 368 ' 

ESB structure 368 
ESBS operand 368 
NAME operand 367 
NEBNAME operand 368 
NEBS operand 368 
TIME operand 368 
DFHSNT 

control section — DFHSNT 
TYPE=INITIAL 221 
DFHSNT TYPE=FINAL 223 
example 224 
sign-on procedure 221 
terminal operators — DFHSNT 
TYPE=ENTRY 222 
DFHSNT TYPE=ENTRY 

NAMFORM=DEC operand 223 
OPCLASS operand 223 
OPIDENT operand 222 
OPNAME operand 222 
OPPRTY operand 223 
PASSWRD operand 222 
SCTYKEY operand 223 
TYPE=ENTRY operand 222 
DFHSNT TYPE=FINAL 

TYPE=FINAL operand 224 
DFHSNT TYPE=INITIAL 

TYPE=INITIAL operand 221 
DFHSRT 

control section — DFHSRT 
TYPE-INITIAL 225 

end of system recovery table — DFHSRT 
TYPE=FINAL 227 
example 227 

specify system/user abend codes 225 
DFHSRT TYPE=FINAL 

TYPE=FINAL operand 227 
DFHSRT TYPE=INITIAL 
SUFFIX operand 225 
TYPE=INITIAL operand 225 
DFHSRT TYPE=SYSTEM/USER 
abend recovery 226 
DOS/VS abend codes 226 
operating system abend code 225 
OS/VS abend codes 226 
PROGRAM operand 225 
ROUTINE operand 226 
system abend code 225 
TYPE=SYSTEM/USER operand 225 
user-supplied abend code 225 
DFHTACP 

default actions (TCAM) 480 
error messages and codes 677 
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DFHTC CTYPE=CHECK 

CTYPE=CHECK operand 533 
ERROR operand 533 
INVADDR operand 533 
INVID operand 533 
INVLDC operand 533 
INVREQ operand 533 
LASTTRM operand 533 
NORESP operand 533 
DFHTC CTYPE=COMMAND 

COMMAND operand 534 
CTYPE=COMMAND operand 534 
VTAM indicators 449 
DFHTC CTYPE=LOCATE 

CTYPE=LOCATE operand 528 
ERROR operand 528 
find TCTTE 527 
INVADDR operand 528 
INVID operand 528 
LASTTRM operand 528 
LDC operand 528 
NORESP operand 529 
retrieve LDC information 527 
scan TCT 527 
TERM operand 529 
DFHTC CTYPE=STATUS 

CTYPE= STATUS operand 530 
ERROR operand 530 
INVADDR operand 530 
INVID operand 530 
INVLDC operand 530 
INVREQ operand 530 
LASTTRM operand 530 
LDC=YES operand 530 
logical units 463 
NORESP operand 530 
STATUS operand 531 
TERM operand 532 
DFHTC macros 527 
DFHTCP, DFHZCP 448 
DFHTCT 

batch regions — DFHTCT TYPE=IRCBCH 242 
communication lines — DFHTCT 
TYPE=LINE 250 
configurator 228 
control section — DFHTCT 
TYPE=INITIAL 234 

data set control information — DFHTCT 
TYPE=SDSCI 262 

digital response messages for 7770 298 

end of terminal control table 1 — DFHTCT 
TYPE=FINAL 299 
example 300 

intersystem communication links -— 

DFHTCT TYPE=ISLINK 243 
line group types — DFHTCT 
TYPE=GPENTRY 237 
local LDC list — DFHTCT 
TYPE=LDCLIST 249 

system LDC table, extended local LDC 
list (DFHTCT TYPE=LDC) 244 
teletypewriter (WTC only) disconnect 
message 298 

teletypewriter (WTC only) station 
identification 297 
terminal types — DFHTCT 
TYPE=TERMINAL 272 


DFHTCT TYPE=FINAL 

TYPE=FINAL operand 299 
DFHTCT TYPE=GPENTRY 

address of each terminal 240 
ALTSCRN operand 239 
block size 239 
control unit address 239 
CUADDR operand 239 
CUFEAT operand 239 
CUPOSN operand 239 
DOS/VS file names 240 
GPBLKSZ operand 239 
GPNAME operand 240 
GPNTRMS operand 240 
GPSEQLU operand 240 
GPTCU operand 240 
GTYPE operand 238 
line features 240 
LINELST operand 240 
LINFEAT operand 240 
LININL operand 240 
number of terminals 240 
system logical unit number 240 
terminal control table user area 242 
terminal group type 238 
terminal identification 241 
terminal input area length 240,241 
terminal model number 241 
transmission control unit 240 
TRMADDR operand 240 
TRMFEAT operand 241 
TRMIDNT operand 241 
TRMINL operand 241 
TRMMODL operand 241 
TRMPOSN operand 242 
TRMPRTY operand 242 
TRMSTAT operand 242 
TRMUAL operand 242 
TYPE=GPENTRY operand 238 
DFHTCT TYPE=INITIAL 

ACCMETH operand 235 
APPLID operand 235 
GMTEXT operand 235 
IRBUFSZ operand 237 
MODNAME operand 236 
OPNDLIM operand 235 
RAMAX operand 235 
RAMIN operand 235 
RAPOOL operand 235 
RATIMES operand 236 
RESP operand 236 
response type 236 
SUFFIX operand 236 
TYPE=INITIAL operand 234 
DFHTCT TYPE=IRCBCH 

inter-region communication 242 
SESNUMB operand 243 
TYPE=IRCBCH operand 242 
DFHTCT TYPE=ISLINK 

ACCMETH operand 243 
LASTTRM operand 243 
NETNAME operand 244 
network name 244 
SESTYPE operand 244 
SYSIDNT operand 244 
TRMIDNT operand 244 

TRMSTAT-*OUT OF SERVICE'* operand 244 
TYPE=ISLINK operand 243 
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DFHTCT TYPE=LDC 

destination selection 246 
DSN operand 246 
DVC operand 246 
extended local LDC list 247 
LDC operand 246 
LOCAL operand 247 
paging activity 248 
PGESIZE operand 248 
TYPE=LDC operand 245 
DFHTCT TYPE =LDCLIST 
LDC operand 249 

logical device codes (LDCs) 249 
TYPE=LDCLIST operand 249 
DFHTCT TYPE=LINE 

ACCMETH operand 251 
answering list 257 
ANSWRBK operand 254 
automatic answering feature 256 
automatic calling feature 256 
automatic polling feature 256 
binary synchronous communication 
code 254 

BSCODE operand 254 

BTAM define-terminal-list macro 257 

BTAM-expanded ID verification 254 

BTAMRLN operand 255 

buffer receive feature 256 

CLASS operand 255 

CONVTAB operand 255 

data set control name 256 

device classification 255 

DSCNAME operand 256 

ERRMSG operand 256 

FEATURE operand 256 

general poll 257 

GENPOLL=YES operand 257 

INAREAL operand 251 

input BSAM data set control name 257 
ISADSCN operand 257 

LINSTAT= - OUT OF SERVICE* operand 257 

LISTADR operand 257 

lock option 256 

message input area length 251 

negative poll delay 258 

NPDELAY operand 258 

OSADSCN operand 259 

output BSAM data set control name 259 
OUTQ operand 261 
pool of TCTLEs 261 
POOL=YES operand 261 
POOLADR operand 259 
POOLCNT operand 261 
process control information field 
(PCI) 259 

QUEUEID operand 262 
RDYMSG operand 259 
relative line number 255 
RVI (reverse interrupt) 252 
station control feature 256 
switched-line pools 250 
TCAM output process queue 261 
TCAM POOL feature 261 
TCAM process queue 262 
TCAMFET=SNA operand 262 
TCTUAL operand 259 
terminal model number 260 
transmission code 255 
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TRMMODL operand 260 
TRMTYPE operand 252 
TYPE=LINE operand 251 
VRC/LRC checking feature 256 
2260 screen format 261 
7770 ready message 259 
DFHTCT TYPE=SDSCI 

appendage routine 270 
APPENDG operand 270 
autopoll feature 268 
binary synchronous line 
configuration 266 
binary synchronous transmission 
code 265 

BLKSIZE operand 265 
block size 265 
BSCODE operand 265 
BTAM device types 263 
CONFIG operand 266 
CU operand 267 

data definition (DD) statement 270 
data set control name 264 
DCB information 262 
DDNAME operand 270 
DEVADDR operand 267 
DEVICE operand 263 
DSCNAME operand 264 
DTF information 262 
EOM operand 267 
EOT operand 267 
ERROPT operand 265 
error recovery procedures 265 
FEATURE operand 268 
first communication line entry 270 
FLNNAME operand 270 
LERBADR operand 266 
line connection 269 
line error recording block 266 
LINELST operand 269 
MACRF operand 270 
mode of communication 271 
MODE operand 271 
MODELST operand 269 
MONDLY operand 269 
motor-on optional feature 269 
number of retries 269 
online terminal test facility 270 
online test facility 266 
OPTCD operand 271 
RECFM operand 271 
record format 271 
RETRY operand 269 
SWITCH operand 269 
SYNAD operand 272 
system/7 f special features 268 
TCAM work unit 271 
TERMTST operand 270 
text-read errors 265 
text-write errors 265 
TYPE-SDSCI operand 263 
DFHTCT TYPE=TERMINAL 
ACCMETH operand 277 
alternate page size 277 
alternate screen size 239,278 
alternative printer 277 
ALTPGE operand 277 
ALTPRT operand 290 
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DFHTCT TYPE=TERMINAL (continued) 
ALTSCRN operand 278 
audible alarm feature 284 
automatic logon 282 
BMS features 278 
BMSFEAT operand 278 
BRACKET operand 279 
bracket protocol 279 
BTAM DFTRMLST macro 293 
BTAM print feature 285 
BTAM terminal address 293 
buffer expansion feature 285 
BUFFER operand 279 
buffer sizes 279 
chain assembly 281 
CHNASSY operand 281 
CLASS operand 281 
COMPAT operand 281 
CONNECT=AUTO operand 282 
copy feature 284 
default page size 287 
default screen size 283 
DEFSCRN operand 283 
device classification 281 
DISMSG operand 283 
FEATURE operand 283 
generate logical units 276 
GMMSG operand 285 
HF operand 297 
INPUT status 296 
IPL status, system/7 296 
LASTTRM operand 275 
LDC operand 286 
local video unit 286 
logical device codes (LDCs) 286 
logical units/session types 275 
LOGMODE operand 286 
LPLEN operand 286 
LVUNIT operand 286 
NETNAME operand 287 
network name 287 
number of concurrent tasks 291 
operator identification code 287 
operator priority 287 
operator security key 287 
OPERID operand 287 
OPERPRI operand 287 
OPERSEC operand 287 
OUT OF SERVICE status 297 
paging activity 289 
PGESIZE operand 287 
PGESTAT operand 289 
pipeline session 289 
PIPELN operand 289 
polling position 290 
POLLPOS operand 290 
primary printer 290 
print line length 286 
printer-adapter feature 283 
PRINTTO operand 290 
process control information field 
(PCI) 291 
RECEIVE status 296 
release logical unit 290 
RELREQ operand 290 
request unit 290 
RUSIZE operand 290 
screen format, 2260 295 


DFHTCT TYPE=TERMINAL (continued) 
selector pen feature 284 
SESTYPE operand 275,291 
station address 291 
STN2980 operand 291 
TAB2980 operand 291 
TASKNO operand 291 
TCTUAL operand 291 

terminal control table terminal entry 
(TCTTE) 272 

terminal input/output area length 291 
terminal status 295 
TIOAL operand 291 
transaction code 292 
TRANSACTION status 295 
TRANSCEIVE status 296 
TRANSID operand 292 
TRMADDR operand 293 
TRMIDNT operand 275 
TRMMODL operand 294 
TRMPRTY operand 295 
TRMSTAT operand 295 
TRMTYPE operand 275 
TYPE=TERMINAL operand 275 
uppercase translation 284 
VF operand 297 
VTAM SIMLOGON 282 
2260 compatibility 282 
3270 printer selection 290 
DFHTCT TYPE=TLXID 

LASTID operand 297 
TLXID operand 297 
TYPE=TLXID operand 297 
DFHTCT TYPE=TLXMSG 

TLXMSG operand 298 
TYPE=TLXMSG operand 298 
DFHTCT TYPE=7770MSG 

digital response messages 299 
MESSAGE operand 299 
TYPE=7770MSG operand 299 
DFHTEP 

alternate interface (CICS/OS/VS 
only) 356 

recursive retry routine 354 
DFHTEPM macro examples 340 
DFHTEPM TYPE=ERRPROC 
CODE operand 340 
TYPE=ERRPROC operand 340 
DFHTEPM TYPE=INITIAL 335 
DSECTPR operand 336 
OPTIONS operand 336 
PRINT operand 337 
TYPE=INITIAL operand 335 
DFHTEPT macro examples 347 
DFHTEPT TYPE=BUCKET 
CODE operand 346 
TYPE=BUCKET operand 346 
DFHTEPT TYPE=FINAL 

TYPE=FINAL operand 347 
DFHTEPT TYPE=INITIAL 
MAXERRS operand 342 
MAXTIDS operand 342 
OPTIONS operand 343 
TYPE=INITIAL operand 342 
DFHTEPT TYPE=PERMCODE/ERRCODE 
CODE operand 344 
COUNT operand 344 
TIME operand 345 
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DFHTEPT TYPE=PERMTID 
TRMIDNT operand 343 
TYPE=PERMTID operand 343 
DFHTLT 

control section — DFHTLT 
TYPE=INITIAL 303 

end of terminal list table — DFHTLT 
TYPE=FINAL 304 

entries in terminal list table — 

DFHTLT TYPE=ENTRY 303 
example 304 
message switching 302 
DFHTLT TYPE=ENTRY 

TRMIDNT operand 304 
TYPE=ENTRY operand 303 
DFHTLT TYPE=FINAL 

TYPE=FINAL operand 304 
DFHTLT TYPE=INITIAL 
LDC operand 303 
SUFFIX operand 303 
TYPE=INITIAL operand 303 
DFHTST 

control section — DFHTST 
TYPE=INITIAL 305 
end of temporary storage table — 

DFHTST TYPE=FINAL 308 
example 308 

remote queues — DFHTST TYPE=REMOTE 307 
temporary storage d^taids, DFHTST 
TYPE=RECOVERY/ENTRY 306 
DFHTST TYPE=FINAL 

TYPE=FINAL operand 308 
DFHTST TYPE=INITIAL 
SUFFIX operand 306 
temporary storage ageing limit 306 
TSAGE operand 306 
TYPE=INITIAL operand 306 
DFHTST TYPE=RECOVERY/ENTRY 
DATAID operand 306 
TYPE=RECOVERY/ENTRY operand 306 
DFHTST TYPE =REMOTE 

DATAID operand 307 
RMTNAME operand 307 
SYSIDNT operand 307 
TYPE=REMOTE operand 307 
DFHXLT 

control section — DFHXLT 
TYPE=INITIAL 309 

end of transaction list table — DFHXLT 
TYPE=FINAL 310 

entries in transaction list table, 

DFHXLT TYPE=ENTRY 309 
example 310 
DFHXLT TYPE=ENTRY 

TASKREQ operand 309 
transaction code 309 
TRANSID operand 309 
TYPE=ENTRY operand 309 
DFHXLT TYPE=FINAL 

TYPE-FINAL operand 310 
DFHXLT TYPE=INITIAL 
SUFFIX operand 309 
TYPE=INITIAL operand 309 
DFHZCP, user exit routines 464 
DFHZNAC 

action flags set 460 
logging facility 462 
system sense codes received 698 


DFHZNEPI macros 

DFHZNEPI TYPE=ENTRY 370 
DFHZNEPI TYPE=FINAL 371 
DFHZNEPI TYPE=INITIAL 370 
DFHZNEPI TYPE=ENTRY 370 
NEPCLAS operand 370 
NEPNAME operand 371 
transaction-class error-handling 
routine 370 
DFHZNEPI TYPE=FINAL 

TYPE=FINAL operand 371 
DFHZNEPI TYPE=INITIAL 
DEFAULT operand 370 
DFTRMLST macro, BTAM 293 
digital response messages 299 
DIP operand 202 

DIP, batch data interchange program (see 
DFHSG PROGRAM=DIP) 
disconnect switched line bit 353 
disk device service times 
DASD seek times 602 
DASD timing data 600 
disk extents, nonsequential 40 
DISMSG operand 283 
DL/I 

backout 426 

backout table 420 

buffer pool size 216 

DDIR 317 

DDIR operand 217 

DFHDLDBD 319 

DLTHRED operand 217 

DMBPL operand 217 

ENQ control block space 217 

error-exit 431 

generate DDIR (DFHDLDBD) 319 

generate PDIR (DFHDLPSB) 317 

IMS/VS control blocks 315 

inter-region communication 

IRBUFSZ operand 237 

operand 15 

operand, DFHDLDBD 319 
operand, DFHDLPSB 318 
PDIR 317 
PDIR operand 219 

program communication blocks (PCBs) 316 
program specification blocks (PSBs) 315 
PSB directory (PDIR) list 317 
PSB operand 220 
PSB pool size 220 
PSBPL operand 220 
reference set 590 
restrictions on IMS/VS batch 
programmer 320 
scheduling 220 
shared data base 
support 54,218,235,237,242 
ACCMETH=IRC 70 
APPLID operand 200 
macros and operands 317 
programs 54 
system generation 92 
TCT example 663 
system generation 90,92 
table preparation 315 
with CICS/DOS/VS 91,315 
with CICS/OS/VS 
DBDs 315 
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DL/I (continued) 

with CICS/OS/VS (continued) 

PCBs 315 
PSBs 315 

system generation 91 
DL/I operand, DFHSIT 203 
DL/I shared data base support 
macro/operand checklist 674 
DLI operand 15 
DLTHPED operand 217 
DMBPL operand 217 
DOS/VS 

abend codes 226 
file names 240 
DSB operand 203 
DSCNAME operand 

DFHDCT TYPE=EXTRA 103 
DFHDCT TYPE=SDSCI 109 
DFHTCT TYPE=LINE 256 
DFHTCT TYPE=SDSCI 264 
DSECTPR operand 336 
DSETID operand 542,545 
DSN operand 246 
DTB operand 

DFHPCT TYPE=ENTRY 168 
DFHPCT TYPE=INITIAL 162 
DFHSG PROGRAM=JCP 57 
DTF information 262 
DTIMOUT operand 169 
dummy terminal indicator 353 
DUMMY=YES operand 

DFHSG PROGRAM=BFP 25 
DFHSG PROGRAM=BMS 33 
DFHSG PROGRAM=DCP 44 
DFHSG PROGRAM=DIP 45 
DFHSG PROGRAM=FCP 50 
DFHSG PROGRAM=JCP 57 
DFHSG PROGRAM=KPP 60 
DFHSG PROGRAM=SRP 66 
DFHSG PROGRAM= TDP 82 
DFHSG PROGRAM=TRP 84 
DFHSG PROGRAM=TSP 86 
dump control program (see DFHSG 
PROGRAM=DBP) 

DUMP operand 169 
DUPDSID operand 137 
duplicate data set 137 
DVC operand 246 
DVSUPRT operand 169,463 
dynamic buffer size 202 
dynamic log 202,386 
dynamic open/close 

closing data sets — DFHOC 
TYPE=CLOSE 545 
DFHOC macros 541 
opening data sets — DFHOC 
TYPE=OPEN 541 

program (see DFHSG PROGRAM-OCP) 
switching dump data sets — DFHOC 
TYPE=SWITCH 545 
dynamic reference set 591 
dynamic storage area 
storage cushion 579 
temporary storage 57 9 
VSAM buffer storage 579 
working storage 578 
dynamic transaction backout 
DBP operand 202 


dynamic transaction backout (continued) 
DTB operand 

DFHPCT TYPE=ENTRY 168 
DFHPCT TYPE=INITIAL 162 
DFHSG PROGRAM= JCP 57 
dynamic buffer 202,386 
dynamic log 202,386 
program (see DFHSG PROGRAM= DBP) 
r ecovery/re star t 90 
transaction restart 312,386 
user exits 384 


ECHO transactions 555 
EDF (see execution (command level) 
diagnostic facility) 

EIP, exec interface program (see DFHSG 
PROGRAM=EIP) 

EJECT operand 15 
emergency restart 

data set recovery 417 
how to specify 212 
message logging (VTAM) 456 
post-initialization processing 418 
problem determination 417 
processing transaction backout data 432 
restart emergency restart 418 
system generation 90 
system log data set 418 
system restart data set 418 
table preparation 313 
temporary storage emergency restart 
interval control data recovery 432 
transaction backout 418 
user activity keypointing 436 
VTAM 457 

end-of-data indicator 75 
ENQ control block space 217 
ENQPL operand 217 
enqueue lockout 105 

entries in program list table — DFHPLT 
TYPE=ENTRY 184 
EODI=xx operand 75 
EOFADDR operand 

DFHJC TYPE=GET 403 
DFHKP TYPE=CHECK 436 
DFHKP TYPE=RTBOCTL 434 
DFHKP TYPE=RTBODATA 435 
EOM operand 267 
EOT operand 267 
ERRMSG operand 256 
ERROPT operand 109,265 
error messages and action flags 681 
error messages and codes 
DFHTACP 677 
DFHZNAC 681 
node error program 681 
terminal error program 677 
error messages and default actions 677 
ERROR operand 

DFHTC CTYPE=CHECK 533 
DFHTC CTYPE=LOCATE 528 
DFHTC CTYPE=STATUS 530 
error processing 
error processing execution 330 
error processing routines 361 
error processing, batch logical units 
(TCAM SNA) 470 
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error processor source 339 
error processor vector table (EPVT) 367 
error processors -- DFHSNEP 
TYPE=DEF3 270 366 

error processors for INTLU — DFHSNEP 
TYPE=DEFILU 367 

error processors, user-written 371 
error recovery action 441 
error recovery procedures 265 
error status blocks 373 
error status elements 

DFHTEPT TYPE=PERMCODE/ERRCODE 343 
error status information 363 
error-processor selection 330 
errors and actions unique to TCAM, 

DFHTEP 476 
ESB structure 368 
ESBS operand 368 
ESE (see error status elements) 

ESE information 334 
examples of terminal control table 
preparation 629 

exec interface program (see DFHSG 
PROGRAM=EIP) 

EXEC operand 203 

execution diagnostic facility (EDF) 192,624 
execution speeds 568 

EXP, command language translator program 
(see DFHSG PROGRAM=EXP) 47 

extended local LDC list 247 
extended local LDC list, DFHTCT TYPE=LDC 
logical device codes (LDCs) 244 
PGESTAT operand 248 
EXTENT operand 133 
extents 

journal 394 
maximum number of 133 
EXTRA operand 82 
extrapartition data sets 82 
extrapartition destinations — DFHDCT 
TYPE=EXTRA 

destination identification (DESTID) 103 
multiple extrapartition 
destinations 103 


factors in selecting buffer size 395 
FCP — file control program (see DFHSG 
PROGRAM=FCP) 

FCP operand 203 

FCT — file control table (see DFHFCT) 

FCT operand 204 

FDP operand 204 

FDUMP operand 162,169 

FEATURE operand 

DFHSG PROGRAM=TCP 75 
DFHTCT TYPE=LINE 256 
DFHTCT TYPE=SDSCI 268 
DFHTCT TYPE= TERMINAL 283 
2260 display station 494 
field relocation 30 
FILABL operand 111 
file backout table 420 
file control program (see DFHSG 
PROGRAM=FCP) 


file control table (see DFHFCT) 

file management 116 

file service requests 123 

FILSERV operand 49 

FILSTAT operand 126 

find TCTTE 527 

first communication line entry 270 

first quiesce stage 183 

FIX operand 98,156 

FLDSEP operand 205 

FLDSTRT operand 205 

FLNNAME operand 270 

FMH processing 469 

FMT2260 operand 75 

FMT3270 operand 76 

FN operand 176,191 

forced pageout 190 

format description of TACLE DSECT 350 
FORMAT mode 493 
format of macro instructions 4 
format of records 130 
formatted dump program 
DFHPCT TYPE=ENTRY 169 
DFHPCT TYPE=INITIAL 162 
FDP operand, DFHSIT 204 
formatted 2260 screen 495 
frequency, user activity keypointing 436 
full warm restart 415 
FULLBUF mode 493 
functional groups 176,191 
functions performed by DFHTBP 418 
F2260 operand 203 


GAP — graphic attention program (see 
DFHSG PROGRAM=GAP) 

general entry and initialization 330 
general exit, DFHTEP 331 
general poll 257 

generalized message format, TCAM 481 
generate DDIR (DFHDLDBD) 

data base description block (DBD) 
operand 319 
DBD operand 319 
SUFFIX operand 319 
TYPE=ENTRY Operand 319 
TYPE=FINAL 320 
TYPE=INITIAL operand 319 
generate logical units 276 
generate PDIR (DFHDLPSB) 

MXSSASZ operand 318 
PSB operand 318 
RMTNAME operand 318 
segment search argument 318 
SUFFIX operand 318 
SYSIDNT operand 318 
TYPE=ENTRY operand 318 
TYPE=FINAL operand 319 
TYPE=INITIAL operand 317 
GENPOLL=YES operand 257 
GMMSG operand 285 
GMTEXT operand 235 
GPBLKSZ operand 239 
GPNAME operand 240 
GPNTRMS operand 240 
GPSEQLU operand 240 
GPTCU operand 240 
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graphic attention program (see DFHSG 
PROGRAM=GAP> 

) GROUP operand 372 
GTYPE operand 238 


IADADMI operand 137 
IADIII operand 137 
IALKFL operand 136 
IARLKP operand 136 

ICP — interval control program (see DFHSG 
PROGRAM=ICP) 

ICP operand 205 
ICV operand 205 
ICVR operand 206 
ICVS operand 206 
ICVSWT operand 215 
ICVTSD operand 206 
ID verification, 3740 
ANSWRBK=EXIDVER 503 
IDERROR operand 

DFHJC TYPE=CLOSE 400 
DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 398 
IEFRH macro 469 
IIP operand 206 
IMS/VS control blocks 315 
in-flight tasks 433 
INAREAL operand 251 
INBFMH operand 170 
INBUFF operand 24 
INDAREA operand 126 
INDDEST operand 104 
\ INDDISP operand 141 
index buffers 125 


INDEX operand 

DFHDCT TYPE=INITIAL 101 
DFHFCT TYPE=ALTERNATE 120 
DFHFCT TYPE=DATASET 134 
DFHPCT TYPE=INITIAL 162 
DFHPPT TYPE=INITIAL 187 
index skip feature 133 
indexing 162 

indirect data destinations — DFHDCT 
TYPE=INDIRECT 104 
INDSIZE operand 126 
INDSKIP=YES operand 133 
initial input record 425 
initialization — DFHSG TYPE=INITIAL 13 
initiating transactions 499 
INITRL=YES operand 81 
input BSAM data set control name 257 
input processor, ATP 518 
INPUT status 296 
input user exit (XTCMIN) 483 
inquiry mode, 3735 501 

inter-region communication 
buffer size 237 
DFHSG PROGRAM=ISC 54 
DFHTCT TYPE=IRCBCH 242 
DL/I shared data base 

DFHSG PROGRAM=ISC 54 
IRBUFSZ operand 237 
IRCSTRT operand 217 
macro/operand checklist 674 
programs 54 
SVC 55 

intersystem communication 
DFHDCT TYPE=REMOTE 107 
DFHFCT TYPE=REMOTE 139 
DFHTCT TYPE=ISLINK 243 
DFHTST TYPE=REMOTE 307 
ISC operand 206 
journal records 408 
macro/operand checklist 674 
program group (see DFHSG PROGRAM=ISC) 
session types 244 
TCT example 662 

interval control data recovery 432 
interval control program (see DFHSG 
PROGRAM=ICP) 

INTRA operand 8 2 

intrapartition destinations — DFHDCT 
TYPE=INTRA 104 
intrapartition queues 82 
INVADDR operand 

DFHTC CTYPE=CHECK 533 
DFHTC CTYPE=LOCATE 528 
DFHTC CTYPE=STATUS 530 
INVID operand 

DFHTC CTYPE=CHECK 533 
DFHTC CTYPE=LOCATE 528 
DFHTC CTYPE=STATUS 530 
INVLDC operand 

DFHTC CTYPE=CHECK 533 
DFHTC CTYPE=STATUS 530 
INVREQ operand 

DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 398 
DFHTC CTYPE=CHECK 533 
DFHTC CTYPE= STATUS 530 
IOCP operand 217 


HANDLE ABEND command 381 
header of segmented record — DFHFCT 
TYPE=SEGHEAD 141 
HF operand 297 
High Performance Option (HPO) 

DFHFCT TYPE =ALTERNATE 118 
DFHOC TYPE=OPEN 544 
mixed mode files 118,135 
MODE operand 135,544 
SRBSVC operand 21 
VS AM ICIP 118 

high-level language support group (see 
DFHSG PROGRAM=HLL) 
high-level language trace 63 
HLL, high-level language support (see 
DFHSG PROGRAM=HLL) 

HLLTR operand 63 

host processor response and maximum loading 
derivation of input data 605 
example 605 

treatment of page-faults 607 
host processor utilization 

calculating background processor 
utilization 557 

calculating transaction processor 
utilizations 557 

defining transactions and transaction 
rates 555 

total processor utilization 558 
transaction execution times 556 
HPO — see High Performance Option 118 
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IOERROR operand 

DFHJC TYPE 25 CLOSE 400 
DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 398 
DFHKP TYPE=CHECK 436 
DFHKP TYPE=RTBOCTL 434 
DFHKP TYPE=RTBODATA 435 
IOSIZE operand 127 
IOWORK operand 134 
IPL status, system/7 296 
IPL system/7 

BSC lines 491 
start/stop lines 4 91 
write transaction 491 
IRBUFSZ operand 237 
IRCSTRT operand 217 
IRCSVC operand 55 
ISADSCN operand 257 
ISAM reference set 590 
ISC operand 206 
issue VTAM indicator 527 


JCP operand 206 

JCP, journal control program (see DFHSG 
PROGRAM 22 JCP ) 

JCT — journal control table (see DFHJCT) 
JCT operand 207 
JDEVICE operand 150 
JFILEID operand 

DFHJC TYPE 22 CLOSE 401 
DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 398 
DFHJCT TYPE 25 ENTRY 149 
DFHPCT TYPE=ENTRY 170 
logical units 463 
JID operand 120,127 
job control for sample DFHTEP 
generation 335 
JOBNAME operand 16 
journal 

devices 394 
extents 394 

journal control program (see DFHSG 
PROGRAM=JCP) 
journal control table 

additional journal options 396 
buffer size 394 
journal devices 394 
journal control table (see DFHJCT) 
journal entries in JCT 
journal file identification 127,149 
journal function and module 
identifications 406 
journal management 

application programming 397 
automatic journaling 394 
automatic logging 394 
emergency restart 394 
journal control table 394 
layout and contents of journal 
records 404 
journal records 394 
journaled data 409 
journaling options 149 
journaling requests 128 
journaling, automatic 
JOUROPT operand 149 


JREQ operand 120,128 
JTYPE operand 149 


KCP — task control program (see DFHSG 
PROGRAM=KCP) 

KCP operand 207 
key length 

logical 128 
maximum 144 
physical 124 
keyboard lock feature 76 
keyfield 131 
KEYLEN operand 

DFHFCT TYPE=DATASET 128 
DFHFCT TYPE=REMOTE 139 
DFHFCT TYPE=SHRCTL 144 
keypoint program (see DFHSG PROGRAM=KPP) 
keypoint records 436 
keypointing 

abnormal termination 199 
activity 60 

KPP — keypoint program (see DFHSG 
PROGRAM=KPP) 

KPP operand 207 


LANG operand 

DFHSG PROGRAM 22 EXP 47 
DFHSG PROGRAM= HLL 52 
DFHSG PROGRAM=PCP 63 
last segment set — DFHFCT 
TYPE=SEGLAST 142 
LASTID operand 297 
LASTTRM operand 

DFHTC CTYPE 555 CHECK 533 
DFHTC CTYPE=LOCATE 528 
DFHTC CTYPE 22 STATUS 530 
DFHTCT TYPE=ISLINK 243 
DFHTCT TYPE^TERMINAL 275 
layout and contents of journal records 
journal function and module 
identifications 406 
journaled data 409 
system prefix 407 
user prefix 409 
LDC operand 

DFHTC CTYPE=LOCATE 528 
DFHTCT TYPE 22 TERMINAL 285,303 
LDC=YES operand 530 
LDCs 

DFHTCT TYPE=LDC 244 
DFHTCT TYPE^LDCLIST 249 
extended local list 247 
extended local list for 3770/3790 
BATCHDI 662 
LDC operand 246,249 
3770 batch TCT example 
LEAVE operand 401 
LENGTH operand 108 
LERBADR operand 266 
line 

addressing 499 
connection 269 
error recording block 266 
features 240 

group types -- DFHTCT TYPE 22 GP ENTRY 237 
input/output area (LIOA) 484 
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line (continued) 

locking, TCAM 478 
macro (BTAM/TCAM) 250 
permanent lock 478 
pool restrictions, TCAM 478 
pool specifications, TCAM 477 
SWITCH operand 269 
temporary lock 478 
line pool specifications 

line pool restrictions 478 
POOL feature 477 
LINELST operand 240,269 
LINFEAT operand 240 
LININL operand 240 

LINSTAT=’OUT OF SERVICE * operand 257 
LISTADR operand 257,543 

local LDC list -- DFHTCT TYPE==LDCLIST 249 

LOCAL operand 247 

local video unit 286 

lock feature 499 

lock option 256 

LOCKF=YES operand 76 

LOG operand 120,129 

logic flow, TCAM 472 

logical device codes (LDCs) 244,249 

logical device codes (see LDCs) 286 

logical key length 128 

logical record length 129 

logical record presentation 76,170 

logical unit 

I/O error handling 
(DFHZNAC/DFH ZNEP) 4 58 

logical unit of work 418 
logical units 

DFHZNAC action flags 681 
generate 276 

node error program 361,458 
TCT examples 653 
VTAMDEV operand 79 

logically recoverable destinations 106 

LOGMODE operand 286 

LOGREC operand 76,170 

LPLEN operand 286 

LRECL operand 129,140 

LVUNIT operand 286 


MACRF operand 270 

major access methods, storage requirements 
BDAM reference set 590 
BTAM reference set 588 
DL/I reference set 590 
ISAM reference set 590 
VSAM reference set 589 
VTAM reference set 586 
MAPALGN operand 33 
MAPHC operand 33 

mapping individual records and entire 
chains 465 
mapset suffixes 188 
MAP3270 operand 33 
master index 133 

master terminal program (see DFHSG 
PROGRAM=MTP) 

MAXERRS operand 342 
maximum 

buffer size 395 
key length 144 


maximum (continued) 

number of active asynchronous tasks 201 
number of active tasks 199 
number of extents 133 
MAXTIDS operand 342 
MCP operand 207 
message 

cache 425,457 
control program (MCP) 480 
control program, TCAM 488 
control programs 

TCAM SNA examples 703 
DEST operand 477 
format, TCAM 481 
handler, TCAM 470 
input area length 251 
integrity 179 
logging 455 
option groups 178,455 
protection 179 
protection processing 455 
recovery 418,454 
recovery and emergency restart 
message cache 454 

node abnormal condition program 454 
system log 454 

recovery and resynchronization 422 
routing, TCAM 477 
switching 302,466 
table 419 

MESSAGE operand 298,299 
message option group 171 
message-originated transactions 423 
minimum buffer size 395 
mixed mode files (VSAM ICIP) 135 
MOD operand 16 

mode of communication, BSC 271 
MODE operand 

DFHFCT TYPE-DATASET 135 
DFHOC TYPE=OPEN 544 
DFHTCT TYPE=SDSCI 271 
model-dependent data stream 495 
MODELST operand 269 
modes of compatibility, 2260 493 

modifying terminal control table 

changing status of logical unit 527 
checking outcome of operation 527 
command option (logical units), DFHTC 
CTYPE=COMMAND 534 
issue VTAM indicator 527 
scanning terminal control table 527 
terminal locate function, DFHTC 
CTYPE=LOCATE 527 
MODNAME operand 111,236 
module load sequence — DFHNLT 
TYPE=ENTRY 155 
MODULE operand 155 

modules generated by system generation 
macros 665 
MONDLY operand 269 
motor-on optional feature 269 
MSGCLAS operand 22 
MSGJRNL operand 170,463 
MSGLVL operand 22,207 
MSGPOPT operand 179 
MSGPREQ operand 179,455 
MSTIND=YES operand 133 
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MTP — master terminal program (see DFHSG 
PROGRAM=MTP) 

multiple extrapartition destinations 103 
multiple ISAM data sets 138 
multiple track search 132 
multiprocessor recovery procedures 
BTAM 438 

channel reconfiguration hardware 
(CRH) 438 
TCAM 440 
VTAM 438 

MXSSASZ operand 318 
MXT operand 207 
M32 operand 207 


NAME operand 366 r 367 
NAMF0RM=DEC operand 223 
NEBNAME operand 368 
NEBS operand 368 
negative poll delay 258 
NEPCLAS operand 171,370 
NEPNAME operand 371 
NETNAME operand 

DFHSNEP TYPE=INITIAL 366 
DFHTCT TYPE=ISLINK 244 
DFHTCT TYPE=TERMINAL 287 
network component pathlengths 567 
network name 244,287 
new-line symbol (NL) 498 
NLT — nucleus load table (see DFHNLT) 

NLT operand 208 

node abnormal condition program 

logical unit I/O error handling 458 
node error program 361 
VTAM message recovery 454 
node error blocks 373 
node error program 

DFHZNEPI macros 369 
error messages and action flags 681 
interface module, DFHZNEPI 369 
node abnormal condition program 361 
sample 361 

system sense codes received 698 
terminal control program (VTAM 
portion) 361 
user-written 369 
VTAM error actions 681 
when abnormal condition occurs 361 
3270 unavailable printer 374 
node error table 363 
node error table header 373 
node initialization block (NIB) 450 
non-compatible interfaces 6 
non-conversational transactions 591 
non-message-originated transactions 423 
non-purgeable task 353 
non-VTAM error actions 681 
noncatastrophic failures 458 
nonprotected tasks 455 

nonresident extrapartition data sets 112 
nonsequential disk extents 40,216 
NORESP operand 

DFHJC TYPE=CLOSE 401 
DFHJC TYPE=GET 403 
DFHJC TYPE=0PEN 398 
DFHKP TYPE=CHECK 436 
DFHKP TYPE=RTBOCTL 434 


NORESP operand (continued) 
DFHKP TYPE=RTBODATA 435 
DFHTC CTYPE=CHECK 533 
DFHTC CTYPE=LOCATE 529 
DFHTC CTYPE=STATUS 530 
NOTE operand 57 
N0T0PEN operand 403 
NPDELAY operand 258 
NRECDS operand 133 
NSD operand 40,216 
nucleus load table (see DFHNLT) 
nucleus module name 156 
number of concurrent tasks 291 
number of retries 269 
number of terminals 240 


OBJDSID operand 137 
object compatible interfaces 

control block and area prefix fields 6 
object data set 137 

OCP — dynamic open/close program (see 
DFHSG PROGRAM=OCP) 
online terminal test facility 270 
online test facility 266 
OPCLASS operand 223 
OPEN operand 

DFHDCT TYPE=EXTRA 103 
DFHFCT TYPE=DATASET 130 
DFHJCT TYPE=ENTRY 150 
opening data sets — DFHOC TYPE=0PEN 541 
opening journal data sets — DFHJC 
TYPE=OPEN 397 
operating system 
abend code 225 
abends 89,312 
storage requirements 585 
operating system and major access method 
storage requirements 569 
operator 

identification code 287 
priority 287 
security key 287 
OPERID operand 287 
OPERPRI operand 287 
OPERSEC operand 287 
OPIDENT operand 222 
OPNAME operand 222 
OPNDLIM operand 235 
OPPRTY operand 223 
OPSECUR operand 58 
OPSYS operand 19 
OP TCD operand 271,477 
OPTGRP operand 171 
optional common subroutines 364 
optional error processor for INTLU 365 
optional error processors for 3270 364 

OPTIONS operand 336,343 
OS/VS 

abend codes 226 
JCL options 22 
OSADSCN operand 259 
OSCOR 

definition 580 
operand 218 

OUT OF SERVICE status 297 
outboard formatting 31 
OUTBUFF operand 24 
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output 

BSAM data set control name 259 
processor (CWTR) 519 
user exit (XTCMOUT) 484 
OUTQ operand 261 
overflow records, cylinder 


page alignment 98,156 
page fixing 99,156 
page-chaining command 208 
page-copy command 208 
page-faults 607 
page-fix SVC 19 
page-purge command 208 
page-retrieval command 208 
PAGEIN operand 157 
PAGEOUT operand 99,157 
paging activity 248,289 
PAGING operand 34 
parity check 132 
partition abend recovery 441 
PASSWD operand 120,130 
PASSWRD operand 222 
PBP operand 208 

PCBs (see program communication blocks) 
PCP — program control program (see DFHSG 
PROGRAM= PC P) 

PCP operand 208 

PCT — program control table (see DFHPCT) 

PCT operand 208 

PDIR operand 219 

performance aspects 551 

permanent line lock 478 

PGCHAIN operand 208 

PGCOPY operand 208 

PGESIZE operand 248,287 

PGESTAT operand 248,289 

PGMERID operand 22 

PGMLANG operand 188 

PGMSTAT operand 188 

PGRET operand 208 

PGSIZE operand 209 

phonetic codes and keys 

DFHBIF TYPE=PHONETIC 547 
DFHPHN 547 

DFHSG PROGRAM=BFP 547 
physical I/Os, calculate disk device 
service times 599 
physical key length 124 
physically recoverable destinations 105 
pipeline session 76,289 
PIPELN operand 76,289 
PISCHD operand 220 
PL/I programs 

LANG operand 47,52 
PGMLANG operand 188 
PLI operand 209 
PLI/PL1=SHARE operand 48 
PLILIB operand 48,53 
PLISHRE operand 220 

PLT — program list table (see DFHPLT) 

PLTPI operand 209 

PLTSD operand 209 

PL1/PLI/PL/I operand 53 

poll list, 3600 BSC 505 

polling position 290 

POLLPOS operand 290 


POOL feature, TCAM 477 
pool of common TCTTEs 472 
pool of TCTLEs 261 
POOL=YES operand 261 
POOLADR operand 259 
POOLCNT operand 261 
positioning information 57 
post-initialization phase 182 
post-initialization processing 418 
PPT — processing program table (see 
DFHPPT) 

PPT operand 210 

prefix creation, user journals 58 

PREFIX operand 22 

PRGDLAY=hhmm operand 34 

primary printer 290 

primed storage allocation 175 

print line length 286 

PRINT operand 

DFHSG TYPE=INITIAL 17 
DFHSIT 210 

DFHTEPM TYPE=INITIAL 337 
printer authorization matrix 211 
printer-adapter feature 283 
PRINTTO operand 290 
PRIORTY operand 22 
PRIVATE operand 171 
PRMSIZE operand 175 
problem determination, emergency 
restart 417 

process control information field 
(PCI) 259,291 
process queue, TCAM 262 
processing program table (see DFHPPT) 
processing programs — DFHPPT 
TYPE=ENTRY 187 

processing transaction backout data 
active tasks 433 
DFHKP macro instructions 434 
in-flight tasks 433 
processor console as terminal, TCT 
example 648 
PROCNMS operand 22 
program check 

error recovery action 441 
partition abend recovery 441 
recovery 441 

program checks in application 
programs 89,312 

program communication blocks (PCBs) 316 
program control program (see DFHSG 
PROGRAM=PCP) 

program control table (see DFHPCT) 161 
program error program (DFHPEP) 383 
program generation summary 

modules generated by system generation 
macros 665 

program isolation scheduling 220 
program list table (see DFHPLT) 
program load request 188 
program load sequence — DFHALT 
TYPE=ENTRY 97 
PROGRAM operand 

DFHALT TYPE=ENTRY 98 
DFHPCT TYPE=ENTRY 164 
DFHPLT TYPE=ENTRY 184 
DFHPPT TYPE=ENTRY 187 
DFHSRT TYPE=SYSTEM/USER 225 
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program specification blocks (PSBs) 315 
program storage 578 
PROGRAM =ATP operand 24 
PROGRAM=BFP operand 25 
PROGRAM=BMS operand 27 
PROGRAM=CSA operand 36 
PROGRAM=CSD operand 37 
PROGRAM=CSO operand 39 
PROGRAM=CSS operand 41 
PROGRAM=CSU operand 42 
PROGRAM=DBP operand 43 
PROGRAM=DCP operand 44 
PROGRAM=DFHDELIM operand 
DFHPLT TYPE=ENTRY 184 
PROGRAM=DIP operand 45 
PROGRAM=DL ZSTPO 0 operand 


DFHPLT TYPE=ENTRY 185 
PROGRAM=EIP operand 46 
PROGRAM=EXP operand 47 
PROGRAM=FCP operand 49 
PROGRAM=GAP operand 51 
PROGRAM=HLL operand 52 
PROGRAM=ICP operand 53 
PROGRAM=ISC operand 55 
PROGRAM=JCP operand 56 
PROGRAM=KCP operand 58 
PROGRAM=KPP operand 60 
PROGRAM=MTP operand 61 
PROGRAM=OCP operand 62 
PROGRAM—PCP operand 63 
PROGRAM-RSP operand 64 
PROGRAM=SCP operand 65 
PROGRAM=SRP operand 66 
PROGRAM=TBP operand 67 
PROGRAM=TCP operand 69 
PROGRAM^TDP operand 82 
PROGRAM=TRP operand 84 
PROGRAM=TSP operand 85 
protected tasks 455 
protocol management 468 
PSB directory CPDIR) list 317 
PSB operand 220,318 
PSB pool size 220 
PSBPL operand 220 

PSBs (see program specification blocks) 

PUNSOL operand 77 

purge delay time interval 35 


queue considerations, TCAM 479 
queue locks, TCAM 479 
QUEUEID operand 262 


RAMAX operand 235,452 
RAMIN operand 235 
RAPOOL operand 235 
RAQ=YES operand 77 
RATIMES operand 236,452 
RDYMSG operand 259 
read journal data sets 
backward 411 

DFHJC TYPE=(GETJCA,OPEN) 415 
during CICS/VS execution 410 
forward 412 
offline 410 

read timeout feature 172 


read transaction backout control 
record 434 

read transaction backout data 434 
read-ahead-queuing 77 
ready message, 7770 259 

real or reference set storage requirements 
CICS/VS reference set 591 
major access methods 586 
operating system 585 
RECEIVE status 296 
RECFM operand 271 
RECFORM operand 

DFHDCT TYPE=SDSCI 109 
DFHFCT TYPE=ALTERNATE 120 
DFHFCT TYPE=DATASET 130 
record 

format 130,271 
identification field 136 
length 110 

logical record length 129 
variable length 110 
RECOVER operand 65 
recoverable destinations 82 
recovery/restart 

CICS/VS dynamic transaction 
backout 90,312 

CICS/VS emergency restart 90,313 
CICS/VS warm restart 89,312 
emergency restart 417 
journal management 393 
multiprocessor recovery procedures 437 
node error program 361 
operating system abends 89,312 
program check 441 
program checks in application 
programs 89,312 
system abend 389 
system generation 87 
telecommunications errors 89,311 
terminal error program 325 
transaction abend 377 
transaction restart 312 
warm restart 415 
RECSIZE operand 109 
reference set tables 592 
REGION operand 23 
relative addressing 131 
relative line number 255 
relative power factors 557 
release logical unit 290 
RELOAD operand 188 
RELREQ exit-routine 451 
RELREQ operand 290 
RELTYPE operand 131 

remote files — DFHFCT TYPE=REMOTE 139 
remote temporary storage queues — DFHTST 
TYPE=REMOTE 307 

remote transient data destinations — 
DFHDCT TYPE=REMOTE 107 
replace error processors — DFHTEPM 
TYPE=ERRPROC 339 
request unit 290 

required entries in CICS/VS control tables 
destination control table 621 
DFHPCT TYPE=GROUP 176 
DFHPPT TYPE=GROUP 191 
processing program table 625 
program control table 622 
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required entries in CICS/VS control tables 
program control table (optional 
features) 624 
RES operand 189 
RESEND operand 64 

resend program (see DFHSG PROGRAM=RSP) 

reset transaction backout pointer 435 

RESIDNT operand 104 

resource limit 144 

RESP operand 236 

response type 236 

restart emergency restart 418 

RESTART operand 171 

restrictions on IMS/VS batch application 
programmer 320 
retrieve LDC information 527 
RETRY operand 269 
REUSE operand 106 
REWIND operand 110 
RKP operand 131 
RLR operand 211 
RMTNAME operand 

DFHDCT TYPE=REMOTE 108 
DFHDLPSB TYPE=ENTRY 318 
DFHFCT TYPE=REMOTE 140 
DFHPCT TYPE=ENTRY 172 
DFHTST TYPE=REMOTE 307 
rotational position sensing 139,600 
ROUTINE operand 226 
routing mechanism 363 
ROUTING operand 35,465 
RPFs (see relative power factors) 

RPG II programs 

LANG operand 47,52 
PGMLANG operand 188 
RPLs 451 

RPS=SVA operand 139 
RSCLMT operand 144 
RSDBLKS operand 61 
RSP — resend program (see DFHSG 
PROGRAM=RSP) 

RTIMOUT operand 172 

RUSIZE operand 290 

RVI (reverse interrupt) 252 


sample node error program 

common subroutine vector table 363 
compatibility with sample TEP 362 
components 362 
DFHSNEP TYPE=INITIAL 366 
error processing routines 361 
error processor vector table 363 
error processor vector table (EPVT) 367 
error processors — DFHSNEP 
TYPE=DEF3270 366 

error processors for INTLU — DFHSNEP 
TYPE=DEFILU 367 
error status information 363 
node error table 363,367 
optional common subroutines 364 
optional error processor for INTLU 365 
optional error processors for 3270 364 

routing mechanism 363 
sample node error table 367 
user-supplied error processors, DFHSNEP 
TYPE=ERRPROC 371 


sample TCAM SNA message control 
programs 703 

sample terminal error program 
common subroutines 331 
components 327 

default threshold count limits 344 
define terminal error blocks 

tables, DFHTEPT TYPE=PERMTID 343 
DFHTEP tables 341 
DFHTEPM TYPE=INITIAL 335 
DFHTEPT TYPE=PERMCODE/ERRCODE 343 
error processing execution 330 
error processor source 339 
error status element (ESEs) 328 
error-processor selection 330 
general entry and initialization 330 
general exit 331 
generate sample TEP module 335 
job control for sample DFHTEP 
generation 335 
messages 

action flag names 333 
DECB information 333 
DECB operand 333 
ESE information 334 
TACLE information 334 
overview 332 

replace error processors, DFHTEPM 
TYPE=ERRPROC 339 
tables 

default threshold count limits 346 
DFHTEPT macro examples 347 
DFHTEPT TYPE=BUCKET 346 
DFHTEPT TYPE=INITIAL 342 
TEP default table 329 
TEP error table 328 
terminal error blocks 328 
terminal identification and error-code 
lookup 330 

TYPE=PERMCODE/ERRCODE operand 344 
sample terminal error program module 
DFHTEPM macro examples 340 
end of sample DFHTEP — DFHTEPM 
TYPE=FINAL 340 
TYPE=FINAL operand 340 
scanning terminal control table 527 
scheduling 

program isolation 220 
segment intent 220 

SCP — storage control program (see DFHSG 
PROGRAM=SCP) 

SCP operand 211 
screen format, 2260 295 

screen sizes 

alternate 278 
default 283 

screen techniques, 2260 495 

SCRNSZE operand 163,172 
SCS operand 211 
SCTYKEY operand 223 
search argument type 138 
seek time 599 
SEGLENG operand 140,141 
segment characteristics 140 
segment indicator field 141 
segment intent scheduling 220 
segment length 140 

segment processing, OPTCD operand 477 
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segment processing, TCAM 477 
segment search argument 318 
segment sets — DFHFCT TYPE=SEGSET 142 
segments of segmented record — DFHFCT 
TYPE=SEGDEF 140 
SEGNAME operand 140,143 
SEGSET operand 142 
selective transaction abend 389 
selector pen feature 284 
SEPASMB operand 101 
sequence of events, TCAM 472 
service request block SVC 20,220 
SERVREQ operand 119,122 
SESNUMB operand 243 
session types 

intersystem communication 244 
logical units 275 
SESTYPE operand 275,291 
SETEOM macro 470 
short wait interval 215 
sign-on procedure 221 
sign-on table (see DFHSNT) 
single keystroke retrieval 35 
SIT ~ system initialization table (see 
DFHSIT) 

SIVOL=YES operand 398 
size of RPL pool 466 
SKR operand 212 
SKR3270 operand 35 
SMI operand 77 
SMPDATE operand 20 
SMPLKED operand 20 
SMPSIZE operand 20 
SNA character string (SCS) 468 
SNT — sign-on table (see DFHSNT) 
source compatible interfaces 6 
specific error conditions — DFHTEPT 
TYPE=BUCKET 346 
SPURGE operand 173 
SRBSVC operand 20,220 
SRCHM operand 131 
SRCHTYP operand 137 

SRP — system recovery program (see DFHSG 
PROGRAM= SRP) 

SRP operand 212 
SRT — system recovery table 
abend codes — DFHSRT 
TYPE=SYSTEM/USER 225 
SRT — system recovery table (see DFHSRT) 
STAGE2 operand 


DFHSG 

PROGRAM=ATP 

24 

DFHSG 

PROGRAM=BFP 

25 

DFHSG 

PROGRAM=CSD 

37 

DFHSG 

PROGRAM=C SO 

39 

DFHSG 

PROGRAM=CSS 

42 

DFHSG 

PROGRAM=CSU 

42 

DFHSG 

PROGRAMEDBP 

43 

DFHSG 

PROGRAM=DCP 

44 

DFHSG 

P ROGRAM= DIP 

46 

DFHSG 

PROGRAMMEIP 

46 

DFHSG 

PROGRAM=EXP 

48 

DFHSG 

PROGRAM=GAP 

51 

DFHSG 

PROGRAM=HLL 

52 

DFHSG 

PROGRAM=ICP 

53 

DFHSG 

PROGRAM=JCP 

57 

DFHSG 

PROGRAM=KC P 

59 

DFHSG 

PROGRAM=KPP 

61 

DFHSG 

PROGRAM=MTP 

62 


STAGE2 operand (continued) 

DFHSG PROGRAM=OCP 62 
DFHSG PROGRAM=RSP 65 
DFHSG PROGRAM= SCP 65 
DFHSG PROGRAM= SRP 67 
DFHSG PROGRAM=TBP 68 
DFHSG PROGRAM=TCP 77 
DFHSG PROGRAM=TDP 83 / 

DFHSG PROGRAM=TRP 84 
DFHSG PROGRAM=TSP 86 
DFHSG TYPE=INITIAL 17 
START operand 212 

start-of-message indicator (SMI) 498 
starter system library 11,18 
startup, TCAM 485 
STATERR operand 

DFHJC TYPE=CLOSE 401 
DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 399 
static CICS/VS area requirements 
CICS/VS modules 570 
CICS/VS table sizes 575 
static reference set 591 
station address 291 
station control feature 256 
STATUS operand 531 
STATUS=FIRST operand 21 
STN2980 operand 291 
storage control program (see DFHSG 
PROGRAM^SCP) 
storage cushion 

SCS operand 212 
size 212 
storage area 579 
storage recovery 65 
storage violation dump 213 
strings 132 
strings (GET only) 136 
STRNO operand 120,132,144 
STRNOG operand 120,136 
structure of this manual 3 
SUFFIX operand 

DFHALT TYPE=INITIAL 97 
DFHDCT TYPE=INITIAL 102 
DFHDCT TYPE=SDSCI 110 
DFHDLDBD TYPE=INITIAL 319 
DFHDLPSB TYPE=INITIAL 318 
DFHFCT TYPE=INITIAL 118 
DFHJCT TYPE=INITIAL 148 
DFHNLT TYPE=INITIAL 155 
DFHPCT TYPE=INITIAL 163 
DFHPLT TYPE^INITIAL 184 
DFHPPT TYPE=INITIAL 187 


DFHSG 

PROGRAM= BFP 

26 

DFHSG 

PROG RAM= BMS 

35 

DFHSG 

PROGRAM=CSA 

36 

DFHSG 

PROGRAM=DBP 

43 

DFHSG 

PROGRAM=DCP 

44 

DFHSG 

PROGRAM=DIP 

46 

DFHSG 

PROGRAM= EXP 

48 

DFHSG 

PROGRAM=FCP 

50 

DFHSG 

PROGRAM=ICP 

54 

DFHSG 

PR0GRAM=ISC 

55 

DFHSG 

PROGRAM=JCP 

58 

DFHSG 

PROG RAM= KC P 

59 

DFHSG 

PROGRAM= KPP 

61 

DFHSG 

PROG RAM= PC P 

64 

DFHSG 

PROGRAM=SCP 

66 
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SUFFIX operand (continued) 

DFHSG PROGRAM= S RP 67 
DFHSG PROGRAM=TCP 78 
DFHSG PROGRAM= TDP 83 
DFHSG PROGRAM=TRP 84 
DFHSG PROGRAM= TSP 86 
DFHSIT 213 

DFHSRT TYPE=INITIAL 225 
DFHTCT TYPE=INITIAL 236 
DFHTCT TYPE=TERMINAL 303 
DFHTST TYPE=INITIAL 306 
DFHXLT TYPE=INITIAL 309 
superset ISAM logic module — DFHFCT 
TYPE=LOGICMOD 

multiple ISAM data sets 138 
SVC operand 41 
SVD operand 213 
SWITCH operand 269 
switched BSC temporary text delay 
(TTD) 357 

switched line disconnected bit 353 
switched-line pools 250 
switching dump data sets — DFHOC 
TYPE=SWITCH 545 
SYMBADR operand 545 
SYNAD operand 272 
syntax notation 3 
SYSIDNT operand 

DFHDCT TYPE=REMOTE 108 
DFHDLPSB TYPE=ENTRY 318 
DFHFCT TYPE =REMOTE 139 
DFHPCT TYPE=ENTRY 173 
DFHTCT TYPE=ISLINK 244 
DFHTST TYPE=REMOTE 307 
system abend code 225 

system abend, abnormal termination 389 
system generation 

ATP— asynchronous transaction 
processing program 23 
BFP — built-in functions program 24 
BMS — basic mapping support program 26 
CSA — common system area 35 
CSD — control system dummy group 36 
CSO — control system operational 
group 37 

CSS — control system service group 41 
CSU — control system utility group 42 
DBP — dynamic transaction backout 
program 42 

DCP — dump control program 44 

DFHSG macros 12 

DFHSG PROGRAM^ATP 23 

DFHSG PROGRAM=BFP 24 

DFHSG PROGRAM^BMS 26 

DFHSG PROGRAM= CSA 35 

DFHSG PROGRAM=CSD 36 

DFHSG PROGRAM= CSO 37 

DFHSG PROGRAM=CSS 41 

DFHSG PROGRAM=CSU 42 

DFHSG PROGRAMEDBP 42 

DFHSG PROGRAM=DCP 44 

DFHSG PROGRAM=DIP 45 

DFHSG PROGRAM=EIP 46 

DFHSG PROGRAM=EXP 47 

DFHSG PROGRAM=FCP 48 

DFHSG PROGRAM=GAP 51 

DFHSG PROGRAM=HLL 51 

DFHSG PROGRAMS CP 53 


system generation (continued) 


DFHSG 

PROGRAM=ISC 

54 

DFHSG 

PROGRAM=JCP 

55 

DFHSG 

PROGRAM=KCP 

58 

DFHSG 

PROGRAM=KPP 

59 

DFHSG 

PROGRAM=MTP 

61 

DFHSG 

PROG RAM= OC P 

62 

DFHSG 

PROGRAM=PCP 

62 

DFHSG 

PROG RAM= RSP 

64 

DFHSG 

PROGRAM— SCP 

65 

DFHSG 

PROGRAM= SRP 

66 

DFHSG 

PROGRAM=TBP 

67 

DFHSG 

PROGRAM=TCP 

68 

DFHSG 

PROGRAM=TDP 

81 

DFHSG 

PROG RAM= TRP 

84 

DFHSG 

PROGRAM=TSP 

85 

DIP — 

■ batch data 

interchange 


program 45 
DL/I 90 

EIP — exec interface program 46 
EXP, command (EXEC) language translator 
program 47 

FCP — file control program 48 
GAP — graphic attention program 51 
HLL — high-level language support 
group 51 

ICP — interval control program 53 
initialization — DFHSG TYPE=INITIAL 13 
intersystem communication (see DFHSG 
PROGRAM=ISC) 

JCP — journal control program 55 
KCP — task control program 58 
KPP — keypoint program 59 
management programs, list of 12 
modules generated 13,665 
MTP — master terminal program 61 
OCP - dynamic open/close program 62 
PCP — program control program 62 
recovery/restart 87 
RSP — resend program 64 
SCP — storage control program 65 
service programs, list of 12 
SRP — system recovery program 66 
TBP — transaction backout program 67 
TCP — terminal control program 68 
TDP — transient data control 
program 81 

termination — DFHSG TYPE=FINAL 87 
TRP — trace control program 83 
TSP — temporary storage control 
program 85 

TYPE=FINAL operand 87 
utility program 12 
system initialization overlays 

system initialization program 523 
system initialization processing 182 
system initialization program 
overlays 523 

system initialization table (see 
DFHSIT) 195 

system LDC table, DFHTCT TYPE=LDC 
logical device codes (LDCs) 244 
PGESTAT operand 248 

system LDC table, extended local LDC list 
(DFHTCT TYPE=LDC) 244 
system log 454 
system log data set 418 
system logical unit number 240 
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system modification program 20 
system prefix 407 
system recovery program (see DFHSG 
PROGRAM=SRP) 

system recovery table (see DFHSRT) 

system restart data set 418 

system sense codes received by DFHZNAC 698 

system stall purge indicator 173 

system/3, TCT example 643 

system/7 

IPL status 296 
special features 268 


tab feature 78 
tab feature, 2260 496 

TAB operand 78 
table preparation 

ALT — application load table 97 
DCT — destination control table 99 
DL/I 315 

FCT — file control table 116 
JCT — journal control table 147 
NLT — nucleus load table 151 
PCT — program control table 161 
PLT — program list table 182 
PPT — processing program table 186 
recovery/restart 311 

SIT — system initialization table 195 
SOT — sign-on table 221 
SRT — system recovery table 224 
TCT — terminal control table 228 
TLT — terminal list table 302 
TST — temporary storage table 305 
XLT — transaction list table 308 
2260 compatibility for 3270 494 

TAB2980 operand 291 
TACLE 

action and information bits 352 

action bits 352 

address contents 348 

DSECT, format description 350 

information 334 

task attach user exit (XATTACH) 483 
task control program (see DFHSG 
PROGRAM=KCP) 

TASKNO operand 291 
TASKREQ operand 164,309 
TBLFIX operand 78 

TBP " transaction backout program (see 
DFHSG PROGRAM=TBP) 

TCAM 

abend/restart 486 

application program interface 470 

communication control byte(s) 480 

data format 472 

DD card correlation 471 

default actions taken by DFHTACP 480 

devices 480 

generalized message format 481 

input event 483 

input process queue 471 

input user exit (XTCMIN) 483 

line input/output area (LIOA) 484 

line locking 478 

line pool restrictions 478 

line pool specifications 477 

logic flow 472 


TCAM (continued) 

message control program 488 
message control program (MCP) 470,480 
message handler 470 
message routing 477 

multiprocessor recovery procedures 440 

OPTCD operand 477 

output event 484 

output process queue 261 

output user exit (XTCMOUT) 484 

permanent line lock 478 

POOL feature 261,477 

pool of common TCTTEs 472 

process queue 262 

queue considerations 479 

queue locks 479 

segment processing 477 

sequence of events 472 

startup 485 

task attach user exit (XATTACH) 483 
TCT example 651 
temporary line lock 478 
terminal entries 471 
terminal error program 476 
terminal errors 

terminal abnormal condition 
program 325 

terminal control program 325 
terminal error program 325 
termination 486 
TPROCESS block 470 
unsolicited input 479 
user exits 483 
work area 484 
work unit 271 
XATTACH 483 
2260 482 

3270 482 

TCAM SNA 

batch processing 470 
communication control byte(s) 468 
device message handler (DMH) 468 
device message handler control 468 
devices 262 
error processing 470 
error processing for batch logical 
units 470 
FMH processing 469 
IEFRH macro 469 
MCP examples 703 
protocol management 468 
SETEOM macro 470 
SNA character string (SCS) 468 
TCAMFET= SNA operand 262,468 
transaction control 469 
with CICS/OS/VS 468 
TCAMFET=SNA operand 262,468 
TCAMSIP=YES operand 41 
TCAPCARO field 389 
TCLASS operand 173 
TCM3270=YES operand 81 

TCP — terminal control program (see DFHSG 
PROGRAM=TCP) 

TCP operand 213 

TCT — terminal control table (see DFHTCT) 
TCT operand 213 
TCTUA operand 21 
TCTUAL operand 259,291 
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TDP operand 213 

TDP, transient data control program (see 
DFHSG PROGRAM=TDP) 

TEBs (see terminal error blocks) 
telecommunications errors 89,311 
teletypewriter (WTC only) 

disconnect message — DFHTCT 
TYPE=TLXMSG 298 
error conditions 358 
station identification — DFHTCT 
TYPE=TLXID 297 
TCT example 637 

teletypewriter exchange terminal (CPT- 
TWX), TCT example 636 
temporary line lock 478 
temporary storage 
ageing limit 306 
backout 422 
dataids 306 
emergency restart 432 
message cache 454 
recovery 422 
table (see DFHTST) 

temporary storage control program (see 
DFHSG PROGRAM=TSP) 

TEP default table 329 
TEP error table 328 
TERM operand 529,532 

terminal abnormal condition line entry 
(TACLE) 326 

terminal address, BTAM 293 
terminal control program (see DFHSG 
PROGRAM=TCP) 

terminal control program (VTAM 
portion) 361 

terminal control table (see DFHTCT) 
terminal control table line entry 250 
terminal control table terminal entry 
(TCTTE) 272 

terminal control table user area 242 
terminal control, DFHTC macros 462 
terminal entries, TCAM 471 
terminal error blocks 328 
terminal error program 

CICS/VS components 325 
error messages and codes 677 
error messages and default actions 677 
errors and actions unique to TCAM 476 
non-VTAM error actions 681 
switched BSC temporary text delay 
(TTD) 357 
TCAM 476 

teletypewriter (WTC only) 358 

when abnormal condition occurs 325 

2740 model 2 358 

3270 locked buffer 360 

3270 unavailable printer 359 

3275 dialed 30-second timeout 360 

3600 BSC 360 

7770 32-second timeout 357 
terminal error purge indicator 174 
terminal group type 238 
terminal identification 241 
terminal identification and error-code 
lookup 330 

terminal input area length 240,241 
terminal input/output area length 291 


terminal list table (see DFHTLT) 
terminal locate function, DFHTC 
C TYPE=LOCATE 527 
terminal model number 241,260 
terminal operators — DFHSNT 
TYPE=ENTRY 222 

terminal scan delay interval 206 
terminal status 295 

terminal types — DFHTCT TYPE=TERMINAL 272 
termination, system generation 87 
termination, TCAM 486 
TERMTST operand 270 

test response to CTYPE requests, DFHTC 
CTYPE=CHECK 532 

test transaction backout response 435 
text-read errors 265 
text-write errors 265 
TIME operand 345,368 
TIOAL operand 291 
TIOTYPE operand 174 
TLXID operand 297 
total processor utilization 558 
TPMARK-NO operand 111 
TPP operand 213 
TPROCESS block 470 
TPURGE operand 174 
trace control program (see DFHSG 
PROGRAM=TRP) 

trace table alignment 159 
trace table entries 
track search, SRCHM operand 132 
transaction 

automatic initiation (ATI) 71,463 
class 173 

class, logical units 459 
code 

TRANSID operand 292,309 
control information — DFHPCT 
TYPE=ENTRY 163 
control, TCAM SNA 469 
description options — DFHPCT 
TYPE=OPTGRP 178 
execution times 556 
I/O processing 174 
identification 

TRANSID operand 165 
options 462 
priority 175 
restart facility 171,386 
security key 174 
status 175 
TWASIZE operand 175 
types 

BASE 555 
ECHO 555 

work area size 175 
transaction abend 

abnormal termination 378 
creating task abend exit 382 
DFHPC TYPE=SETXIT macro 381 
HANDLE ABEND command 381 
program error program (DFHPEP) 383 
user exits in DFHDBP 384 
transaction backout 

committed output message 423 
data base backout 421 
data written to system log 423 
default data base backout 421 
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transaction backout (continued) 

DL/I backout 426 
DL/I backout table 420 
DL/I error-exit 431 
file backout table 420 
file-error-exit 430 
functions performed 418 
initial input record 425 
initialization 419 

initialization/termination exit 428 
input-exit 429 
logical unit of work 418 
message backout table 419 
message cache 425 
message recovery 418 
message recovery and 
resynchronization 422 
message-originated transactions 423 
non-message-originated transactions 423 
program 418 

program (see DFHSG PROGRAM=TBP) 
table 419 

temporary storage backout 422 
temporary storage recovery 422 
transient data recovery 425 
user input exit 421 
user-written exits 427 
transaction control information — DFHPCT 
TYPE=ENTRY 

transaction status 175 
transaction list table (see DFHXLT) 
transaction processor utilizations 557 
TRANSACTION status 295 
transaction-class error routine 459 
transaction-class error-handling 
routine 370 
TRANSCEIVE status 296 
TRANSEC operand 174 
TRANSID operand 

DFHDCT TYPE=INTRA 106 
DFHPCT TYPE=ENTRY 165 
DFHTCT TYPE=TERMINAL 292 
DFHXLT TYPE=ENTRY 309 
transient data control program (see DFHSG 
PROGRAM=TDP) 

transient data recovery 82,425 
translate tables 78 
transmission code 255 
transmission control unit 240 
trigger level 100,107 
TRIGLEV operand 107 
TRMADDR operand 240,293 
TRMFEAT operand 241 
TRMIDNT operand 

DFHTCT TYPE=GPENTRY 241 
DFHTCT TYPE=ISLINK 244 
DFHTCT TYPE=TERMINAL 275 
DFHTEPT TYPE=PERMTID 343 
DFHTLT TYPE=ENRTY 304 
VTAM 466 

TRMINL operand 241 
TRMMODL operand 

DFHTCT TYPE=GPENTRY 241 
DFHTCT TYPE=LINE 260 
DFHTCT TYPE=TERMINAL 294 
TRMPOSN operand 242 
TRMPRTY operand 242,295 


TRMSTAT operand 

DFHTCT TYPE=GPENTRY 242 
DFHTCT TYPE=TERMINAL 295 
VTAM 463 

TRMSTAT=’ OUT OF SERVICE’ operand 244 

TRMTYPE operand 252,275 

TRMUAL operand 242 

TRNPRTY operand 175 

TRNSTAT operand 175 

TRNSUFX operand 102 

TRP — trace control program (see DFHSG 
PROGRAM=TRP) 

TRP operand 214 
TRT operand 214 
TSAGE operand 306 
TSEGIND operand 141 
TSMGSET operand 214 
TSP operand 214 

TSP, temporary storage control (see DFHSG 
PROGRAM=TSP) 

TST operand 214 
TWASIZE operand 175 

TWASIZE, CICS/VS-supplied transactions 623 
type of journal data set 149 
type of segment indicator field 141 
TYPE=ALTERNATE operand 119 
TYPE=BUCKET operand 346 
TYPE=CHECK operand 435 
TYPE=CLOSE operand 400,545 
TYPE=CSECT/DSECT operand 198 
TYPE=DATASET operand 
DFHFCT 121 

TYPE=DEFILU operand 367 
TYPE=DEF3270 operand 366 
TYPE=ENTRY operand 
DFHALT 98 
DFHDLDBD 319 
DFHDLPSB 318 
DFHJCT 148 
DFHNLT 155 
DFHPCT 164 
DFHTLT 30 3 
DFHXLT 309 

TYPE=ERRPROC operand 340,371 
TYPE=EXTRA operand 103 
TYPE=FINAL 
operand 

DFHALT 99 
DFHDCT 112 
DFHDLDBD 320 
DFHDLPSB 3l9 
DFHFCT 145 
DFHJCT 151 
DFHPCT 180 
DFHSG 87 

TYPE=GETB/GETF/NOTE/POINT operand 402 
TYPE=GPENTRY operand 238 
TYPE=GROUP operand 176,191 
TYPE=INDACC operand 136 
TYPE=INDIRECT operand 104 
TYPE=INITIAL 
operand 

DFHALT 97 
DFHDCT 101 
DFHDLDBD 319 
DFHDLPSB 317 
DFHFCT 118 
DFHJCT 148 
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operand (continued) 

DFHNLT 155 
DFHPCT 161 
DFHSG 14 

TYPE=INTRA operand 105 
TYPE=IRCBCH operand 242 
TYPE=ISLINK operand 243 
TYPE=LDC operand 245 
TYPE=LDCLIST operand 249 
TYPE=LINE operand 251 
TYPE=LOGICMOD operand 139 
TYPE=OPEN operand 397,541 
TYPE=OPTGRP operand 179 
TYPE=PERMCODE/ERRCODE operand 344 
TYPE=PERMTID operand 343 
TYPE=RECOVERY/ENTRY operand 306 
TYPE= REMOTE operand 
DFHDCT 107 
DFHFCT 139 
DFHTST 307 

TYPE=RTBOCTL operand 434 
TYPE=RTBODATA operand 435 
TYPE=RTBOEND operand 435 
TYPE=SDSCI operand 108,263 
TYPE=SEGDEF operand 140 
TYPE=SEGHEAD operand 141 
TYPE=SEGLAST operand 142 
TYPE=SEGSET operand 142 
TYPE=SHRCTL operand 143 
TYPE=SWITCH operand 545 
TYPE=SYSTEM/USER operand 225 
TYPE=TERMINAL operand 275 
TYPE=TLXID operand 297 
TYPE=TLXMSG operand 298 
TYPE=7770MSG operand 299 
TYPEFLE operand 110 


UCTRAN operand 78 
unsolicited input 77 
unsolicited input, TCAM 479 
uppercase translation 78,284 
UPRFX operand 58 
USAGE=MAP operand 190 
use count for BMS maps 191 
user activity keypointing 
frequency 436 
keypoint records 436 
transaction CSKP 436 
user exits 

asynchronous transaction processing 517 
CRDR exit routine 518 
CWTR exit routine 519 
CICS/VS management programs 

conventions and guidelines 513 
CICS/VS VTAM terminal control 464 
dynamic transaction backout 384 
TCAM 483 

transaction backout program 427 
user input exit 421 
user prefix 409 
user prefix creation 58 
user-supplied abend code 225 
user-supplied error processors, DFHSNEP 
TYPE=ERRPROC 371 
user-written node error programs 

common subroutine vector table 373 
default transaction-class routine 370 


user-written node error programs (continued) 
DFHZNEPI macros 369 
DFHZNEPI TYPE=INITIAL 370 
error status blocks 373 
NEPCLAS operand 171 
node error blocks 373 
node error table header Node Error 
Table Header: This 373 
user-written error processors 371 
user-written terminal error programs 
abend transaction bit 353 
address contents of TACLE 348 
DFHTEP recursive retry routine 354 
disconnect switched line bit 353 
dummy terminal indicator 353 
example 354 

format description of TACLE DSECT 350 
non-purgeable task 353 
switched line disconnected bit 353 
TACLE action bits 352 

TACLE, action and information bits 352 
write abort 353 


VERIFY=YES operand 132 
Version 1 compatibility 21,41 
VF operand 297 
virtual storage 

application programs 580 
CICS/VS dynamic storage area 578 
operating system and major access 
method requirements 569 
OSCOR definition 580 

static CICS/VS area requirements 570 
VOLERR operand 399,403 
volume error 399 
VOLUME operand 399 
volume switching 149 
VRC/LRC checking feature 256 
VSAM 

buffer space 125 
buffer storage 579 
buffers 125 
enhancements 22 
ICIP and mixed mode files 544 
mixed mode files — DFHFCT 
TYPE=ALTERNATE 118 
operand 18 
reference set 589 
shared resources 18 
shared resources control — DFHFCT 
TYPE-SHRCTL 143 
storage requirements 589 
VSAM SHR operand 18 
VSAME operand 22 
VSAME operand 21 
VSAMSHR operand 18 
VTAM 

access method control block (ACB) 449 
action flags set by DFHZNAC 460 
APPLID operand 449 
BMS 465 

BMSDEV operand 465 

BUFFER operand 453 

chain assembly (CHNASSY) 452 

CICS/VS good morning message 235 

CONNECT=AUTO 450 

control blocks 587 
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VTAM (continued) 
devices 79 

DFHPCT TYPE=OPTGRP 455 
DFHTC CTYPE=COMMAND 449 
DFHTC CTYPE=STATUS 463 
DFHTCP, DFHZCP 448 
DFHZNAC 681 

DFHZNAC logging facility 462 
DVSUPRT operand 463 
emergency restart 457 
error actions 681 
I/O error handling 

DFHZNAC/DFHZNEP 458 
indicators 

DFHTC CTYPE= COMMAND 527,534 
JFILEID operand 463 
logical record presentation 465 
logical units with CICS/VS 447 
mapping individual records and entire 
chains 465 
message cache 457 
message logging 455 
message option groups 455 
message protection processing 455 
message recovery 454 
message recovery and emergency 
restart 454 
message switching 466 
MSGJRNL operand 463 
MSGPREQ operand 455 

multiprocessor recovery procedures 438 

node abnormal condition program 458 

node initialization block (NIB) 450 

noneatastrophic failures 458 

nonprotected tasks 455 

operand 18 

protected tasks 455 

RAMAX operand 452 

RATIMES operand 452 

RECEIVE macro 451 

reference set 586 

RELREQ exit-routine 451 

ROUTING operand 465 

RPLs 451 

session types 275 
SIMLOGON 282 
size of RPL pool 466 
SNA COMMANDS 

DFHTC CTYPE=COMMAND 534 
SNA commands (indicators) 449 
statistics 466 
storage requirements 587 
system sense codes received 698 
terminal control, DFHTC macros 462 
terminal/logical units 275 
transaction class 459 
transaction options 462 
transaction-class error routine 459 
TRMIDNT operand 466 
TRMSTAT operand 463 

user exit routines for CICS/VS terminal 
control 464 
ZATTACH exit 465 
ZINPUT exit 464 
VTAMDEV operand 79 
V1CMPAT=YES operand 41 


warm keypoint 415 
warm restart 

full warm restart 415 
system generation 89 
table preparation 312 
warm keypoint 415 
weighted retrieval function, DFHSG 
PROGRAM=BFP 25 

when abnormal condition occurs 
sample node error program 361 
sample terminal error program 327 
terminal abnormal condition line entry 
(TACLE) 326 

user-written node error programs 369 
user-written terminal error 
programs 348 
work area 484 
working storage 578 
WRAPLST operand 80 
write abort 353 
WRKAREA operand 36,215 


XATTACH exit, TCAM 483 
XATTACH operand 80 
XDERROR operand 43,68 
XDSPCHR operand 59 
XFERROR operand 43,68 
XFETCH operand 64 
XICEEXP operand 54 
XINIT operand 

DFHSG PROGRAM=DBP 43 
DFHSG PROGRAM=TBP 68 
XINPUT operand 

DFHSG PROGRAM=DBP 43 
DFHSG PROGRAM= FCP 50 
DFHSG PROGRAM= TBP 68 
DFHSG PROGRAM=TCP 80 
DFHSG PROGRAM= TDP 83 
DFHSG PROGRAM=TSP 86 
XINPUTC operand 51 
XLT operand 215 
XOUTPUT operand 

DFHSG PROGRAM=FCP 51 
DFHSG PROGRAM= TCP 80 
DFHSG PROGRAM= TDP 83 
DFHSG PROGRAM=TSP 86 
XRDATT operand 80 
XTCMIN exit, TCAM 483 
XTCMIN operand 81 
XTCMOUT exit, TCAM 484 
XTCMOUT operand 81 
XTRANID operand 175 
XTYPREQ operand 

DFHSG PROGRAM=FCP 51 
DFHSG PROGRAM=ICP 54 
DFHSG PROGRAM=KCP 59 
DFHSG PROGRAM=SCP 66 
DFHSG PROGRAM=TDP 83 
DFHSG PROGRAM=TSP 87 


ZATTACH exit, VTAM 465 
ZATTACH operand 80 
ZCP operand 215 
ZINPUT exit* VTAM 464 
ZINPUT operand 81 
ZOUTPUT operand 81 
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1050 data communication system, TCT 
example 630 


2260 display station 
CMPT60L operand 73 
COMPAT operand 

DFHPCT TYPE=ENTRY 168 
DFHSG PROGRAM= TCP 74 
DFHTCT TYPE =TERMINAL 282 
compatibility for 3270 493 

table preparation 494 
FEATURE operand 494 
FMT2260 operand 75 
FORMAT mode 493 
formatted screen 495 
FULLBUF mode 493 
initiating transactions 499 
line addressing 499 
lock feature 499 
model-dependent data stream 495 
modes of 3270 compatibility 
FORMAT mode 493 
FULLBUF mode 493 
new-line symbol (NL) 498 
screen format 261,295 
screen formats 75 
screen techniques 495 
start-of-message indicator (SMI) 498 
tab feature 496 
TCT examples 
local 650 
remote 631 

2845/2848 tab feature 499 


2314 direct access storage facility, TCT 
example 648 


2540 card read punch/1403 printer, TCT 
example 647 


2740 communication terminal 

model 2, 10-second delay 358 
TCT example 632 


2741 communication terminal, TCT 
example 632 


2770 data communication system, TCT 
example 642 


2780 data transmission terminal, TCT 
example 642 


2845/2848 tab feature 499 


2980 general banking terminal system, TCT 
example 638 


3270 information display system 
generate logical units 275 
large screen support 
ALTPGE operand 277 
ALTSCRN operand 278 
DEFSCRN operand 283 
SCRNSZE operand 163,172 
locked buffer, DFHTEP 360 
PA/PF keys 164 

printer authorization matrix 211 
printer selection 

ALTPRT operand 290 
PRINTTO operand 290 
TCAM 482 
TCT examples 
BTAM 639 

BTAM, local (OS/VS) 649 
large screen support 657 
VTAM 657 
3275 (DOS/VS) 644 
unavailable printer 
DFHTEP 359 
DFHZNEP 374 
2260 compatibility 493 
3275 dialed 30-second timeout, 
DFHTEP 360 


3600 finance communication system 
generate logical units 275 
TCT example 653 


3600 finance communication system (BSC) 
buffer depletion 506 
poll list 505 
system generation 505 
TCT example 641 

terminal control table preparation 505 


3600 pipeline logical unit, TCT 
example 654 


3614 consumer transaction facility, TCT 
example 654 


3650 retail store system 

generate logical units 275 
TCT examples 

host command processor LU 656 
host conversational (3270) LU 656 
host conversational (3653) LU 655 
interpreter LU 656 
pipeline LU 655 


3735 programmable buffered terminal 
inquiry mode 501 
system generation 501 
TCT example 645 

terminal control table preparation 501 


3740 data entry system 
ID verification 503 
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3740 data entry system (continued) 
system generation 503 
TCT examples 

dial/switched (DOS/VS) 646 
multipoint (DOS/VS) 640 
point-to-point 647 

terminal control table preparation 503 
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TCT example 658 


3770 data communication system 
generate logical units 275 
TCT examples 

batch data interchange LU 659 
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full function LU 659 
LDCs for batch LU 661 
non-programmable 658 
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example 640 
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TCT examples 

batch data interchange LU 661 
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SCS printer LU 660 
3270-display LU 659 
3270-printer LU 660 
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Summary of Amendments to the Third Edition 


The following information has been added in the third edition of the 
manual to cover the features provided by CICS/VS Version 1, Release 4s 

• System Generation 

— DFHSG PROGRAM=ISC has been added to provide intersystem 

communication support between two or more connected CICS/VS 
systems, or inter—region communication between CICS/OS/VS and 
the DL/I batch region. 

— RPG II (CICS/DOS/VS only) and assembler language are supported 
under the command level application programming interface, and 
are specified in DFHSG PROGRAM=EXP. 

• Table Preparation 

— Intersystem communication support is provided through the 

DFHTCT TYPE=ISLINK, DFHDCT TYPE=REMOTE, DFHFCT TYPE=REMOTE, and 
DFHTST TYPE=REMOTE macro instructions. Inter—region 
communication between CICS/OS/VS and the DL/I batch region is 
provided through the DFHTCT TYPE=IRCBCH macro and the IRBUFSZ 
operand in DFHSIT. 

— The transaction restart facility may be used to restart 

transactions automatically after an abnormal termination and 
subsequent dynamic transaction backout. This facility is 
provided through the RESTART operand in DFHPCT TYPE=ENTRY. 

— The 3770 Data Communication System may be used under VTAM in a 
manner similar to the 3790 full function logical unit. 

TRMTYPE—3770 and SESTYPE=USERPROG must be specified in the 
DFHTCT TYPE=TERMINAL macro. 

— The execution (command level) diagnostic facility (EDF) allows 
command—level application programs to be debugged before the 
program is executed. This facility is provided through the 
DFHPPT macro instruction. Appendix A contains further 
information. 

— New 3270 displays and printers can be used with CICS/VS. 

Information on how to generate this support can be found in the 
DFHPCT TYPE= INITIAL, DFHPCT TYPE=ENTRY, and DFHTCT 
TYPE=TERMINAL macros, and in Appendix D. 

The following technical and editorial changes have been made in this 
edition of the manual: 

• The macros of the destination control table, the file control 
table, and the terminal control table are arranged in alphabetic 
order within the TYPE=INITIAL and TYPE=FINAL macros. 

• The DFHTCT TYPE=GPENTRY macro (for CICS/DOS/VS only) is documented 
in full. 

• Chapters 2.3, 2.4, 3.3, and 3.4 have been created from the 
recovery/restart and DL/I information that were formerly in 
Chapters 2.2 and 3.2. 
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• Chapters 4.2 ("The Terminal Error Program*) and 4.3 (“The Node 
Error Program") have been formed from the information that was 
formerly in Chapter 4.3. The information on system abends 

(formerly Chapter 4.2 ) now appears in Chapter 4.10. 

• The DFHPCT TYPE=GROUP and DFHPPT TYPE=GROUP macros have been added 
to the program control table and processing program table 
respectively, and allow the system programmer to specify CICS/VS- 
supplied transaction identifications and application program names 
in a simplified manner, on a function basis. Appendix A contains 
further information. 

• Part 8 ("Host Processor Resource Estimation") has been restructured 
and expanded. 

In addition, in Technical Newsletter SN33—6217, the following major 
changes have been made to the manuals 

• DFHSG TYPE=INITIAL S 

— The DLI=REMOTE option has been added to allow users to indicate 
that all DL/I data bases to be accessed reside on remote 
CICS/VS systems. 

— The SMPDATE, SMPLKED, and SMPSIZE operands have been removed. 

• DFHSG PROGRAM=HLL s 

— Support for the PL/I F Compiler has been removed. 

• DFHSG PROGRAM=TDP and DFHPCT TYPE=INITIAL s 

— Support for VSAM intrapartition queues has been included. 

• DFHJCT TYPE=ENTRY s 

— The SYSWAIT operand has been added to allow journal control 
input/output operations to be initiated immediately. 

• DFHNLT : 

— The default load order for CICS/OS/VS Version 1, Release 4 has 
been updated. The PROTECT operand has been provided for MVS 
users to load modules into a protected area of storage. 

• DFHSIT ; 

— The CICSSVC and SRBSVC operands have been removed. 

• Chapter 3.4 contains additional information on how to specify DLI 
support in CICS/VS tables. 

• Part 8 has been updated to include additional performance 
information, in particular on Intersystem Communication. 

All changes are indicated by a revision bar in the left-hand margin. 
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Chapter 2.2. System Generation 


This chapter describes the macros that may be used to generate a CICS/VS 
system. 

The macro instructions are described in the following order: 

• DFHSG TYPE=INITIAL 

• DFHSG PROGRAM=xxx in alphabetic order of program name 

• DFHSG TYPE=FINAL 

In each case, the operands (except TYPE and PROGRAM, which always appear 
first) are listed in alphabetic order starting with the mandatory 
operands. Operands that apply to DOS/VS only or 0S/VS only are listed 
separately in alphabetic order. The syntax notation is described in 
Chapter 1.1. 

Appendix C provides a list of the modules generated by the DFHSG 
macro instructions. 


INITIALIZATION — DFHSG TYPE=INITIAL 


A DFHSG TYPE=INITIAL macro instruction must precede each set of system 
generation macro instructions. Procedures developed from the use of 
this macro instruction can be reused for subsequent generations of the 
entire system or for parts of the system. 

The following modules are generated in response to this macro 
instruction: 

• DFHHPSVC — the service request block (SRB) type 6 SVC for the High 
Performance Option (HPO) 

• DFHCSVC - the page fix/free SVC 

Note : The STARTER=YES parameter is an internal operand used by IBM and 
is not intended for general use. It is documented here for reasons of 
completeness and clarity only. 
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|DFHSG 

| TYPE=INITIAL 




1 T,ACCTID={CICS1accounting—information} 1 




1 r,ASMBLR=fIFOXOOIASSEMBLY I assembler-name} } 




| [,{DL11DLI} = {NO| YES|string|REMOTE} ] 




| [ ,EJECT= {YES|n} ] 




1 r.JOBNAME={CICSliobname}1 



1 

j [ ,MOD= (program[ , suffix ]. . . ,program[ , suffix j) } 



1 

I r,PRINT={LIST|NOLIST} 



1 

1 f,XREF1NOXREF1SHORTXREF} 

| t-0 S/VS 



1 

| {,DSECT|NODSECT|SOMEDSECT} 

J t-0 s/vs 



1 

| [,DSLIST]] 



1 

1 T.STAGE2={FORCE I SELECTIVE}1 



1 

| f #VSAM={YES 1 NO} 1 



1 

| { , VSAMSHR={NO I YES} ] 



1 

| [,VTAM={YES|NO}} 

1 



I 

1 

I 

1 For DOS/VS Only 

1 



1 

1 

1 

1 r »DEVICE={TAPE 12314 I 333013340 13350} 1 



I 

1 

1 For OS/VS only 



I 

1 

i 

| r,CICSSVC={2011 number}1 



I 

\ [,DEBCHK={YES|} ] 



1 

| r.OPSYS={VSl|VS2}r.number 11 



1 

j [ , SRBSVC=number ] 




| [,STATUS=FIRST] 



1 

1 r,TCTUA= (VARIABLEr.VlCOMPAT D 1 



1 

| f # VSAME={NO I YES} 1 



1 

1 

1 

1 OS/VS JCL OPTIONS 



1 

1 

■ 

| [ ,CLASS=jobclass) 



1 

| [ ,CONDCD= ( (code,operator) ,...) ] 



1 

| [ ,MSGCLAS=x ] 



1 

| [ ,MSGLVL={0|1|2} ] 



1 

I r #PGMERID= { ‘SYSTEM—PROGRAMMER* I •programmer-name*}1 



1 

| [ ,PREFIX={CICS|prefix} ] 



1 

| [ ,PRIORTY=nn] 



1 

1 T .PROCNMS= (DFHASMVS . DFHLNKVS.DFHDPDVS . DFHAUPLK. 




1 DFHSMPVS . DFHEITCL.DFHEITPL ,DF HEITAL) 



1 

| | (procedure—names) ] 




| [,REGION=storage ] 



TYPE=INITIAL 

specifies that this is the initial macro instruction in a 
CICS/VS system generation run. 
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ACCTlD=accounting—information 

specifies the JCL accounting information for the CICS/VS 
generation cataloged procedure. The default is ACCTID=CICS. 

For O S/VS, information must not be included within quotes. For 
further details of valid accounting information options, see 
OS/VS 1 JCL Reference or OS/VS2 JCL . For DOS/VS, the accounting 
information must be included within in quotes. For further 
information about accounting information, see the DOS/VS System 
Control Statements manual. 

For both DOS/VS and O S/VS, if the accounting information 
contains quotes or ampersands, two quotes or two ampersands 
must be coded for every single one. 


ASMB LR=a ssembler-name 

specifies the name of the assembler to be used during stage 2 
of system generation and to produce the proper JCL. The system 
modification program will use this name for assemblies. The 
default is ASMBLR=ASSEMBLY for CICS/DOS/VS, and ASMBLR=IFOXOO 
for CICS/OS/VS. 


| DLI=NO| YES|string|REMOTE 

specifies whether the Data Language/I (DL/I) interface is to be 
included in this generation of CICS/VS. The default is DLI=NO. 
This parameter should not be specified if DL/I ENTRY DOS/VS is 
being used, but is required if DL/I DOS/VS or IMS/VS are being 
used* For further information, see “DL/I with CICS/OS/VS“ in 
Chapter 2.4. 

NO 

indicates that DL/I support is not required 

YES 

| indicates that DL/I support is to be included (DOS/VS 

I only) . 

string 

is a string in the form n.n.n (where n is a single digit) • 
The string indicates the level of IMS/VS for which 
CICS/OS/VS support is to be included. DLI=1.1.4 or later 
is the only value that can be specified for CICS/VS Version 
1, Release 4. 

| REMOTE 

| indicates that the CICS/VS system requires DL/I support, 

| but that all the data bases that are to be accessed reside 

| on remote CICS/VS systems and are to be accessed through 

| intersystem communication. This option is only required if 

| the IMS/VS macro and object module libraries are not 

| available when the CICS/VS system is generated. 

| DLI=YES must also be specified in DFHSIT or as a startup 

| override when DLI=REMOTE is used. The BUFPL, DLTHRED, 

j DMBPL, ENQPL, PISCHD, PSB, and PSBPL operands need not be 

| specified in DFHSIT. However, an empty DDIR is required, 

| together with a PDIR that contains details of remote PSBs. 

Note ; *DLI“ may also be written as “DL1“. 


Chapter 2.2. DFHSG TYPE=INITIAL 
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EJECT=YESIn 

specifies the effect of page ejects in the assembly listings of 
the CICS/VS modules. The default is EJECT==YES. 

This operand allows for paper saving by reducing the size of 
the CICS/VS module listings depending on the value chosen for 
•n*. This operand has no effect if PRINT=NOLIST is specified. 

YES 

indicates that normal page ejects will occur, 
n 

specifies a number from 1 to 99 which controls the number 
of spaces to be substituted for page ejects. A separator 
line preceded and followed by a 1 space x* statement (where 
x = n—2) will replace page ejects. 


JOBNAME=jobname 

specifies the first part of a JCL (0S/VS) or job control 
POS/VS) jobname for system generations. The default is 
JOBNAME=CICS. The complete jobname is a concatenation of the 
jobname operand (truncated to four characters) plus the three 
characters of the program name, plus any suffix (truncated to 
one character, if necessary, to keep within the limit of eight 
characters) . For JOBNAME=NEWRUN, PROGRAM=KCP, and SUFFIX=03, 
the complete jobname would be NEWRKCPO. For the default 
JOBNAME operand, PROGRAM=KCP, and SUFFIX=2, the jobname would 
be CICSKCP2. 

Note s The program name for DFHSG TYPE=INITIAL is provided by 
the system as GEN. Therefore, the default jobname is CICSGEN. 


MOD=program,suffix 

indicates that the Stage 1 output produced by DFHSG will 
consist only of the jobs for those programs named in this 
operand. All other Stage 2 jobs will be suppressed. Stage 2 
jobs for a program named in this operand will be suppressed 
unless the SUFFIX operand in the appropriate DFHSG PROGRAM=xxx 
macro corresponds to the suffix parameter in the MOD operand. 
This allows APAR fixe$ to be applied to individual versions of 
the modules produced by DFHSG PROGRAM=xxx macros. 

program 

is the name of a CICS/VS program (for example, TCP) • 
suffix 

is the optional suffix appended to the program. If this 
parameter is omitted, an unsuffixed version of the program 
will be searched for in the Stage 1. If ALL is specified, 
all Stage 1 versions will be dealt with. 

Notes If the suffix parameter is omitted, a comma must still 
be specified. 

For example: 
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DFHSG TYPE=INITIAL,MOD== (KCP, 1A,SIA1, ,DCP,ALL,PCP, ,TRP,2A) 

DFHSG PROGRAM=KCP,SUFFIX=1A 

DFHSG PR0GRAM=KCP,SUFFIX==5A 

DFHSG PROGRAM=CSO 

DFHSG PROGRAM=PCP 

DFHSG PR0GRAM=DCP,SUFFIX=3A 

DFHSG PROGRAM=DCP,SUFFIX=4A 

DFHSG PR0GRAM=TRP,SUFFIX=2A 

DFHSG PR0GRAM=TRP,SUFFIX=6A 

DFHSG TYPE=FINAL 

will produce Stage 1 jobs for: 

DFHKCP1A 

DFHSIA1 

DFHPCP 

DFHDCP3A 

DFHDCP4A 

DFHTRP2A 

and will suppress Stage 1 jobs for: 

DFHSPP (from DFHKCP) 

DFHKCP5A 

DFHTRP6A 

All the other jobs normally produced by DFHSG PROGRAM=CSO 


PRINT=print-option 

specifies the printing option for the assembly of the CICS/VS 
modules during stage 2 of system generation. 


LIST 

indicates that the total assembly listing is to be printed, 
NOLIST 

indicates that only assembly error messages are to be 
printed. 

Note : NOLIST, if specified, overrides all options in the XREF, 
DSECT, and DSLIST groups. 

XREF 

indicates that the cross reference list is to be printed. 
NOXREF 

indicates that no cross reference list is to be printed. 
SHORTXREF 

indicates that the cross reference list is to contain only 
symbols which are referenced. This option is valid in 
OS/VS only. 

DSECT 

indicates that all CICS/VS DSECTs are to be printed for 
each program. 

NODSECT 

indicates that none of the CICS/VS DSECTs will be printed. 
All printing, including TWA fields, register equates, and 
comments, is suppressed until the DFHVM macro instruction 
(beginning of the CSECT) . 
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SOMEDSECT (CICS/OS/VS only) 

indicates that the large DSECTs (CSA, TCA, TCTLE, and 
TCTTE) are not to be printed. 

DSLIST 

indicates that all CICS/VS DSECTs are to be printed as a 
separate listing at the end of stage 2. Thus, to avoid 
having the DSECTs printed twice, NODSECT should also be 
specified. 


STAGE2 =FORCE |SELECTIVE 

specifies whether DFHSG will produce Stage 2 jobs for all 
programs requested. The option specified in this macro sets 
the defaults for the STAGE2 operands of the rest of the system 
generation macros. The default for DFHSG TYPE=INITIAL is 
STAGE2=FORCE. 

Note : A user-supplied suffix on a system generation program 
will be ignored if the Stage 2 job is suppressed, and 
STAGE2=SELECTIVE will be ignored for a given program if the 
user supplies an exit routine name for that program. 

FORCE 

generates the Stage 2 jobs for all system generation 
programs requested, and should be specified if the IBM- 
supplied starter system library is not being used. 

SELECTIVE 

indicates that Stage 2 jobs may be selectively suppressed. 
This option may only be used.when programs are being added 
to the IBM—supplied starter system library. 

STAGE2=SELECTIVE causes DFHSG to suppress generation of the 
Stage 2 job for any module if a preassembled version of the 
module has been supplied on the CICS/VS starter system 
library. MNOTEs produced during the Stage 1 assembly 
indicate which jobs have been suppressed and which suffixed 
modules should be used in their place, and which have been 
generated. 


VSAM=YES|NO 

indicates whether VSAM support is required. The default is 
YES. 

YES 

indicates that VSAM support is required. 

NO 

indicates that VSAM support is not required. This option 
prevents certain assemblies from searching the DOS/VS or 
OS/VS libraries for VSAM macros. 


VSAMSHR=YES|NO 


specifies whether the VSAM shared resources option is to be 
used. This is available only with OS/VS1 Release 4 or later, 
OS/VS2 Release 3 or later, DOS/VS Release 33 or later, or as an 
ICR (independent component release) on OS/VS2 Release 1.7 
(SVS) . The default is NO. 
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YES 

indicates that VSAM resources will be shared. For 
VSAMSHR=YES, VSAM Release 2 must be available in the host 
operating system. VSAMSHR=YES may not be specified if 
VSAM=NO is specified. 


NO 

indicates that VSAM resources are not to be shared. 


VTAM =YES INO 

indicates whether VTAM support is required. The default is 
YES. 


YES 

indicates that VTAM support is required. 


indicates that VTAM support is not required. This option 
prevents certain assemblies from searching the DOS/VS or 
OS/VS libraries for VTAM macros. 


For CICS/DOS/VS only 


DEVICE=device 

If this parameter is specified, it becomes the default device 
for keypoint, trace control, and dump control programs. Note, 
however, that DEVTCE=TAPE is not allowed for DFHSG PROGRAM=KPP• 
If the device type in DFHSG TYPE=INITIAL defaults to TAPE and 
if the DEVICE operand is not specified in DFHSG PROGRAM=KPP, 
DFHKPP will override TAPE with 2314 as the device type. 


For CICS/QS/VS only 


CICSSVC=number 

specifies the SVC number to be used for the CICS/VS page fix or 
anticipatory paging SVC which CICS/VS will provide. This SVC 
is required if page fixing is to be used in CICS/OS/VS. The 
SVC is used if ANTICPG=YES or ANTICPG=number is specified in 
DFHPCT TYPE=ENTRY, if RES=FIX is specified in DFHPPT 
TYPE=ENTRY, or if FIX=YES is specified in DFHNLT TYPE=ENTRY. 
Number may be in the range 200 to 255; the default is 201. 

This operand controls the name given to the SVC routine that is 
generated by the DFHSG TYPE=INITIAL macro. 


DEBCHK=YES|NO 

applies only to 7770 devices under OS/VS1 or OS/VS2. For 
OS/VS1, the DEB checking facility is optional and has a default 
of No. For OS/VS2, DEB checking is required and has a default 
of YES. DEBCHK=NO should only be specified if there are no 
7770 devices on the OS/VS2 system. 

YES 

indicates that the DEB validity check facility is 
supported. 
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indicates that the DEB validity check facility is not 
supported. 


OPSYS=operating—system 

specifies the environment in which CICS/VS is to operate. The 
default is OPSYS= (VS1,6) . 

VS1|VS2 

indicates the applicable operating system, 
number 

specifies a whole decimal number indicating the release 
number. The maintenance release fraction is not used. For 
examples VS1 Release 6 would be specified as 
0PSYS= (VS1,6) , VS2 Release 1.6 would be denoted by 
OPSYS= (VS2,1) , and VS2 Release 3 would be indicated by 
OPSYS= (VS2,3) . 


SRBSVC=nuraber 

specifies, for 0S/VS2 Release 3.7 (with the supervisor 
performance shippable units 1 and 2) , the type—6 SVC number to 
be used for invoking the service request block (SRB) routine 
provided by CICS/VS. This routine (DFHHPSVC) must have been 
link—edited into the user's MVS operating system as the 
appropriate SVC number, and is required to obtain access to any 
SRB-dependent functions of CICS/VS (VSAM ICIP support and VTAM 
authorized path) . The number specified must be in the range 
200 to 255. 

This operand causes the necessary CICS/VS modules to be 
generated to support VTAM authorized path and VSAM fast path 
options. The files that are to be accessed via VSAM fast path 
processing (VSAM ICIP) are specified in the MODE operand in 
DFHFCT TYPE=DATASET. 

If SRBSVC=number is specified, ClCSSVC=number is also required. 


STATUS=FIRST 

is used to cause the CICS/VS cataloged procedures to be placed 
in SYS1.PROCLIB. In CICS/OS/VS, STATUS=FIRST and 
CICSSVC=number generate a job to assemble and link-edit the 
page-fix SVC to SYS1.SVCLIB (VS1) or SYS1.LPALIB (VS2) . 

STATUS=FIRST and SRBSVC=number will generate a job to assemble 
and link-edit the CICS/OS/VS SRB SVC pFHHPSVC) into the 
CICS/OS/VS load library. 

STATUS=FIRST should be used with each new release to obtain the 
latest cataloged procedures. If TCTUA=V1C0MPAT is specified, 
jobs are created, which modify the DFHTCT macro instruction and 
DFHTCT symbolic storage definition (DSECT) to provide upward 
compatibility from CICS/OS—STANDARD Version 1. 


TCTUA=V1C0MPAT | VARIABLE 

specifies user-defined process control information (PCI) fields 
of fixed length (15 bytes) and/or variable length (0 to 255 
bytes) . These fields are located in the terminal control table 
and can be used as terminal work areas. The default is 
TCTUA=VARIABLE. 
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V1COMPAT 

should only be used by users of earlier versions of 
CICS/OS/VS who are currently using the fixed-length 15-byte 
PCI field (the address of which is at TCTTECI) and who 
desire PCI compatibility with CICS/OS—STANDARD Version 1. 
This option must be specified in conjunction with the 
STATUS=FIRST operand. 

Note : If this option is specified, use of the preassembled 
starter system cannot be guaranteed. 

VARIABLE 

specifies a variable—length (byte aligned) PCI field (the 
address of which is at TCTTECIA and the length of which is 
at TCTTECIL) and should be used by all but CICS/OS-STANDARD 
Version 1 users (who have used PCI fields) if a terminal 
work area is desired. 


VSAME=NO|YES 

indicates whether VSAM enhancements are to be used on OS/VS2 
Release 1 (SVS) . This parameter is ignored for all other 
operating systems. The default is VSAME=NO. 


NO 


indicates that VSAM enhancements are not required. 


YES 

indicates that VSAM enhancements are to be used. VSAME=YES 
may only be used when OPSYS= (VS2,1) is specified. 


0S/VS JCL Options 


The following JCL options may be required for generation of the 
CICS/OS/VS system. For further details refer to the 0S/VS1 JCL 
Reference or OS/VS2 JCL manuals. 


CLASS=jobclass 

is used to assign a jobclass to all Stage 2 jobs. 


CONDCD=code 

specifies the condition codes which, if met on any job step, 
cause further processing of that job to be bypassed. 


MSGCLAS=x 

is used to route all messages issued by the 0S/VS Job Scheduler 
to an output class. 


MSGLVL=value 

specifies the message level desired for the JCL during Stage 2. 
The OS/VS default is MSGLVL=0. 


PGMERID=programme r—name 

specifies the programmer B s name to be placed in the JCL. The 
default is PGMERID= * SYSTEM—PROGRAMMER 1 • 
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PREFIX=prefix 

specifies the index name for CICS/VS system data sets. The job 
control language (JCL) generated specifies these data sets as 
prefix.LOADLIB, prefix.MACLIB, and prefix.SOURCE , where 
“prefix" must conform to the data set naming conventions. The 
default is PREFIX=CICS. 


PRIORTY=nn 

is used to assign a priority to the jobs in Stage 2 of system 
generation. All jobs are given the same priority. 


PROCNMS=procedure—names 

allows the user to specify the names of CICS/VS cataloged 
procedures to be used as follows: 

1. First Name — assembly of CICS/VS programs and user-written 
assembler language programs. 
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PRGD LAY=hhmm 

indicates the purge delay time interval that is added to the 
specified delivery time to determine when a message is to be 
considered undeliverable and therefore purged. This time 
interval is specified in the form ■hhInm ,, (where "hh* represents 
hours from 00 to 99 and “mm* represents minutes from 00 to 59) • 
If PRGDLAY is not specified, a message will remain eligible for 
delivery either until it is purged or until temporary storage 
is reinitialized. The PRGDLAY facility requires ROUTING=YES 
and PAGING=YES to be generated. 

Note that the PRGDLAY value determines the interval between 
terminal page clean—up operations. A very low or zero value 
will prevent other tasks from executing. The actual purge 
delay time interval specified is dependent on individual system 
requirements. 


ROUTING=N0|YES 

indicates whether messages can be routed to a destination other 
than the originating terminal and/or to multiple destinations* 
The default is ROUTING=NO. If ROUTING=YES is specified and the 
user wants to put messages to temporary storage (see DFHBMS 
TYPE=STORE or the PAGING option in the appropriate CICS/VS 
Application Programmers Reference Manual) , the user must also 
specify PAGING=YES. The BMS macro forces PAGING=YES if 
ROUTING=YES is specified. If ROUTING=YES is specified, 
AUTOTRN=YES must be specified in DFHSG PROGRAM=TCP• 

NO 

indicates that routing will not be supported. 

YES 

indicates that routing will be supported. 


SKR3 2 70=NO|YES 

specifies whether single keystroke retrieval is required. The 
default is NO. 

SKR3270=YES requires that MAP3270=YES and PAGING=YES are also 
specified or defaulted. If not specified, they are forced to 
YES and the user is informed. 


SUFFIX=xx 

provides a one— or two—character suffix (other than NO or DY 
which are reserved) for the set of basic mapping support 
programs being generated. This suffix is appended to all 
programs generated except DFHBMSMM, DFHTPQ, DFHTPR, and DFHTPS. 
If this operand is omitted, a suffix is not provided. 


CSA — COMMON SYSTEM AREA 


The system generation macro instruction necessary to generate the common 
system area is DFHSG PROGRAM=CSA• 

The size of the CSA work area (CWA) may also be specified in the 
WRKAREA operand of DFHSIT, or by means of the WRKAREA operator override 
parameter. 
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In addition to generating the CSA f the execution of this macro 
instruction causes the assembly of terminal control's TCA, task 
control's TCA, and, in CICS/DOS/VS, a write—to—operator (WTO) routine. 

Note : Stage 2 jobs will always be produced for DFHSG PROGRAM=CSA. 

i—-r 

|DFHSG 

I 
I 
I 


| PROGRAM=CSA 

| [ ,DATFORM— fmmddyy | ddmmyy l yymmdd} ] 
| [,SUFFIX=xx) 

| [,WRKAREA=£5121number} ] 


PROGRAM=CSA 

indicates that the common system area is to be generated. 


DATFORM=format-of-date-display 

specifies the external date display standard that is required 
by the user. An appropriate indicator setting is made in the 
CSA. This is examined by ClCS/VS—supplied system service 
programs that display a Gregorian date. As part of their 
operation, the indicator can also be examined by customer- 
written programs. It is the user's responsibility to supply 
his own Gregorian date conversion routine, because CICS/VS 
maintains the date in the form * , YYDDD 11 in the CSA. The default 
| is DATFORM=mmddyy. The date format can be changed at system 

I initialization via the DATFORM operand of DFHSIT or by the 

j DATFORM startup override. 


indicates that the date will be in the form of 
month/day/year. 

ddmmyy 

indicates that the date will be in the form of 
day/month/ye ar. 

yymmdd 

indicates that the date will be in the form of 
year/month/day. 


WRKAREA= 512|number 

specifies the number of bytes to be allocated to the common 
work area of the CSA. This area is initially set to binary 
zeros and is available to all programs. The maximum size for 
| the work area is 3584 bytes; the default is WRKAREA=512. The 

| size can be changed at system initialization via the WRKAREA 

| operand in DFHSIT or by the WRKAREA startup override. 


SUFFIX—xx 

provides a one— or two—character suffix for the CSA being 
generated. If this operand is omitted, a suffix is not 
provided. 
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CSD — CONTROL SYSTEM DUMMY GROUP 


If a particular CICS/VS management program (for example, the file 
control program) is not required, the user need not generate that 
program and, as a result, can save the amount of virtual storage that 
would be required to contain the program. However, a dummy program must 
be provided for every CICS/VS management program not actually generated. 
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CICS/VS system is functioning normally , and not, as in the case of the 
transaction backout program, when emergency rest curt is invoked when 
CICS/VS is unable to effect its normal termination process. 

The system generation macro instruction necessary to generate the 
dynamic transaction backout program is DFHSG PROGRAM=DBP. The CICS/VS— 
supplied version of DFHRTY for the transaction restart facility is also 
generated in response to this macro instruction. 


i-1-1-1 

| |DFHSG | PROGRAM=DBP | 

II I I [,DL1={YES|N0}] | 

| | | [,STAGE2={SELECTIVE|FORCE}] | 

| | | [,SUFFIX=xx] | 

| j j [,XDERROR=symbolic—name] I 

| j | [ ,XFERROR=symbolic-name ] I 

| | | [, X INIT=symbo1ic—name] I 

| j j [,XINPUT=symbolic-name] I 

I_I_:_I_I 


PROGRA^DBP 

indicates that the dynamic transaction backout program is to be 
generated. 


| DL1=YES|N0 

| indicates whether DL/I support is required for this program, 

| and may be used to override the option specified in DFHSG 

| TYPE=INITIAL. 


STAG£2=5ELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : In CICS/OS/VS, Stage 2 jobs will always be produced for 
these programs. 


SUFFIX=xx 

is used to provide a unique one- or two-character alphameric 
suffix that identifies the dynamic transaction backout program 
being generated. If this operand is omitted a suffix is not 
provided. 


XDERROR=symbolic-name 

is used to generate linkage to a user-written exit routine when 
an error condition is encountered while attempting DL/I data 
base backout. 
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XFERROR=symbolie—name 

is used to generate linkage to a user—written exit routine when 
an error is detected while attempting file backout. 


XiNiT=symbolic—name 

is used to generate linkage to a user—written exit routine in 
the initalization phase of DFHDBP. 


XINPUT=symbolic—name 

is used to generate linkage to a user—written exit routine 
after a record has been read from the dynamic log. 


DCP — DUMP CONTROL PROGRAM 

The system generation macro instruction necessary to generate the dump 
control program is DFHSG PROGRAM=DCP. 


| | DFHSG | PROGRAM=DCP I 

| | | r * ClCSDMP={NO j YES} 1 | 

| | | [,DUMMY=YES] I 

| | | [,STAGE2={SELECTIVE(FORCE)] | 

| | | [,SUFFIX=xx] | 

III I 

| | | For DOS/VS Only ^ 

I I I I 

| | | [ ,DEVADDR= {010 | nnn) ] I 

| | | [,DEVICE={TAPE12314133301334013350} ] | 

»_i_i-1 


PROGRAM=DCP 

indicates that the dump control program is to be generated. 


CICSDMP=NO|YES 

specifies whether the optional feature of dumping CICS/VS 
tables is to be generated. The default is CICSDMP=NO. 

NO 

indicates that support for dumping CICS/VS tables is not to 
be included. 


YES 

indicates that support for dumping CICS/VS tables is to be 
included. 


DUMMY=YES 

specifies that a dummy dump control program is to be generated. 
This operand may be used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy dump control program. Any 
other operands which may have been included in the DFHSG 
PRO GRAM—DCP macro instruction are ignored. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 
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SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : In CICS/DOS/VS, Stage 2 jobs will always be produced for 

this program• 
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XINPUT=symbolic—name 

generates linkage in the file control programs to a user— 
written exit routine. The linkage is provided after the file 
control table (FCT) is searched in response to an input 
request. For further information concerning user exits, see 
“User Exits for CICS/VS Management Programs* in Chapter 6.2 of 
this manual. 


XINPUTC=symbolic—name 

generates linkage in the file control programs to a user- 
written exit routine. The linkage is provided upon completion 
of an input event, but prior to deblocking requested input 
records. For further information concerning user exits, see 
“User Exits for CICS/VS Management Programs." 


XOUTPUT=symbolic—name 

generates linkage in the file control programs to a user- 
written exit routine. The linkage is provided prior to writing 
data in response to an output request. For further information 
concerning user exits, see “User Exits for CICS/VS Management 
Programs." 


XTYPREQ=symbolie-name 

generates linkage in the file control program to a user-written 
exit routine. The linkage is provided prior to determining 
what type of request for file services was issued. For further 
information concerning user exits, see "User Exits for CICS/VS 
Management Programs." 


GAP — GRAPHIC ATTENTION PROGRAM 


The system generation macro instruction necessary to generate the 
graphic attention program is DFHSG PROGRAM=GAP. This macro instruction 
must be issued only if support for local 2260 is to be generated. This 
macro applies to CICS/OS/VS only, and is not required under TCAM. 

i-1 ' ' ........- - 

|DFHSG | PROGRAM=GAP 

| I [,STAGE2={SELECTIVE|FORCE}] 


PROGRAM=GAP 

specifies support for local 2260 using CICS/OS/VS. 


STAGE 2—S ELECTIVE | FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 
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HLL — HIGH-LEVEL LANGUAGE SUPPORT GROUP 


The high-level language support group allows the COBOL dr PL/I 
application programmer to use the macro interface to CICS/VS. If 
application programs use only the command interface to CICS/VS, the 
high-level language support group is not required. For details of the 
command interface to CICS/VS, see DFHSG PROGRAM=EIP and DFHSG 
PROGRAM=EXP earlier in this chapter. The system generation macro 
instruction necessary to generate the high-level language support group 
is DFHSG PROGRAM=HLL. 

The support programs generated in Response to this macro instruction 
are as follows: 

• CICS/VS preprocessor program pFHPRPR) — for either or both 
languages 

| • Entry interface program (DFHPL10I) for PL/I optimizer (0S/VS only) 

I • PL/I storage allocation program pFHSAP) for PL/I optimizer 

• Shared library transfer vector (PLISHRE) , to interface between PL/I 
optimizer code and its shared library modules (OS/VS only) 

Note : DOS/VS users should ignore any DFHPRPR assembly errors that occur 

if the tape macros DTFMT and MTMOD have been deleted from the source 
statement library. 


i-1-1-1 

| | DFHSG | PROGRAM=HLL \ 

| | | [ ,LANG= (COBOL, PLI) | {COBOL |PLI} ] | 

| | | [,STAGE2={SELECTIVE|FORCE}] | 

II I I 

| | | For OS/VS Only | 

II I I 

II I I [,PLI=SHARE] I 

| I | [,PLILIB=dataset—name] I 

I_I_L. .. . ..- „ .... .1 


PROGRAM=HLL 

indicates that the high-level language support group is to be 
generated. 


LANG=language 

identifies the languages for which support is to be generated. 
The default is LANG= (COBOL,PLI) . 

COBOL 

indicates ANS COBOL support. 

PLI 

indicates PL/I support. Note that this option can also be 
written as: PL/I, PLI, or PL/1. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 
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SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library* 


FORCE 

forces generation of all Stage 2 jobs for this program. 


For CICS/OS/VS only 


| PL1=SHARE 

| indicates that support for the PL/I shared library facility is 

| to be generated. 


PLILIB=dataset—name 

specifies the name of the data set containing the PL/I base 
library. This operand is only applicable with the SHARE option 
of the PLI operand. The default data set name is SYS1.PLIBASE. 


ICP — INTERVAL CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
interval control program is DFHSG PROGRAM=ICP. Unless otherwise 
indicated , the omission of an operand results in the corresponding 
function not being included. 

If interval control requests are used to store data for a future 
task, the temporary storage program (DFHSG PROGRAM=TSP) must be 
generated. 


i-1-1-*——--——i 

| |DFHSG | PROGRAM=ICP I 

| | } [ # STAGE2== {SELECTIVE(FORCE} ] I 

| | | [,SUFFIX=xx] I 

I I I [ # XICEEXP=symbolic—name] I 

| | | [,XTYPREQ=symbolic—name] | 

i_i_» . ...........i 


PROGRAM=ICP 

indicates that the interval control program is to be generated. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

' FORCE ■. ■ . 

forces generation of all Stage 2 jobs for this program. 
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SUFFIX=xx 

is used to provide a one— or two—character alphameric suffix 
for the interval control program beings generated. If this 
operand is omitted, a suffix is not provided. 


XICEEXP=symbolic—name 

is used to allow the interval control program to generate 
linkage to a user-written exit routine when an interval control 
element (ICE) has expired. For further information concerning 
user exits, see "User, Exits for CICS/VS Management Programs* in 
Chapter 6.2 of this manual. 


XT YPREQ=symbol ic—name 

is used to generate linkage to a user—written exit routine at 
the entry point of interval control. For further information 
concerning user exits, see “User Exits for CICS/VS Management 
Programs.“ 


ISC — INTERSYSTEM COMMUNICATION GROUP 


The DFHSG PROGRAM=ISC macro instruction must be coded to provide support 
for an intersystem communication session, where one CICS/VS system 
communicates with another. A terminal control table may also be 
generated with a DFHTCT TYPE=ISLINK macro, together with the appropriate 
operands from the DFHTCT TYPE=INITIAL and TYPE=TERMINAL macros. In 
addition, DFHSG PROGRAM=TCP must be generated with ACCMETH=VTAM and 
VTAMDEV=LUTYPE6. 

The DFHSG PROGRAM=ISC macro is also required if DL/I data base 
sharing is to take place under CICS/OS/VS. A DFHTCT TYPE=IRCBCH macro 
must also be generated, together with the appropriate operands (APPLID 
and IRBUFSZ) from the DFHTCT TYPE=INITIAL macro. In addition, DFHSG 
PROGRAM=TCP must contain ACCMETH=IRC. 

The following programs are generated by the DFHSG PROGRAM=ISC macro 
instruction: 
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DUMMY=YES 

specifies that a dummy system recovery program is to be 
generated. 

This operand is used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy system recovery program. 

Note ; The dummy SRP module intercepts program checks, allowing 
CICS/VS to perform certain clean-up operations. It will issue 
SPIE (OS/VS) or STXIT PC (DOS/VS) macros, but will not handle 
abnormal terminations. However, unlike the full version of the 
SRP, the dummy SRP does not provide recovery action for program 
checks. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : Stage 2 jobs will always be produced for this program in 

CICS/OS/VS. 


SUFFIX=xx 

is used to provide a one— or two-character alphameric suffix 
(other than NO or DY, which are reserved) for the system 
recovery program being assembled. If this operand is omitted, 
a suffix is not provided. 


TBP — TRANSACTION BACKOUT PROGRAM 


The transaction backout program (DFHTBP) is responsible for backing out 
changes made to CICS/VS protected resources by transactions which were 
in-flight at the time that the system was interrupted. This program 
must be generated if the keypoint program is generated with AKP=YES. 

DFHTBP is a required component of emergency restart and is also 
responsible for collecting messages to permit message recovery. 

The system generation macro instruction necessary to generate the 
transaction backout program is DFHSG PROGRAM=TBP. 


| |DFHSG | PROGRAM=TBP 

|| | | [,DL1=£YES|N0} ] 

| | | [,STAGE2={SELECTIVE|FORCE}] 

|| | | [,SUFFIX=xx] 

| | | [,XDERROR=symbolic-name] 

j | | [,XFERROR=symbolic-name] 

| | | [,XINIT=symbolic—name] 

| | | [,XINPUT=symbolic-name] 
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PROGRAM=TBP 


indicates that the transaction backout program is to be 
generated. 


| DL1=YES| NO 

| indicates whether DL/I support is required for this program, 

| and may be used to override the option specified in DFHSG 

| TYPE=INITIAL. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : Stage 2 jobs will always be produced for this program in 

CICS/OS/VS. 


SUFFIX=xx 

is used to provide a one— or two-character alphameric suffix 
(other than NO or DY, which are reserved) for the transaction 
backout program being assembled. If this operand is omitted, a 
suffix is not provided. 


XDERROR= symbo 1 ic—n ame 

is used to generate linkage to a user-written exit routine when 
an error condition is encountered while attempting DL/I data 
base backout. 


XFERROR=symbolie—name 

is used to generate linkage to a user—written exit routine when 
an error is detected while attempting file backout. 


XINlT=symbol ic—name 

is used to generate linkage to a user—written exit routine in 
the initialization and termination phases of DFHTBP• 


XINPUT=symbolie—name 

is used to generate linkage to a user—written exit routine 
after a record has been read from the restart data set. 


TCP — TERMINAL CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
terminal control program is DFHSG PROGRAM=TCP. 
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The programs generated are: 

• Terminal control programs (DFHTCP , DFHZCP # DFHZCA, DFHZCB, DFHZCY, 
DFHZCX, and DFHZCZ) . DFHTCP f DFHZCP, and DFHZCX are for VTAM and 
non—VTAM systems; in a VTAM system, all the modules are needed. 

• Terminal control program print application program pFHP3270) 

• Terminal control program print application programs for 3270 and 
3790 3270-compatible logical units - (DFHPRK, DFHCPY, DFHRKB, and 
DFHEXI) . 

• CICS/VS VTAM good morning message program (DFHGMM) if ACCMETH=VTAM 
is specified. 
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ZATTACH=symbolic—name 

generates linkage in the terminal control program to a user- 
written exit routine (VTAM only) . The linkage is generated at 
the point prior to issuing a task control ATTACH for a 
transaction identification which is received in response to 
polling. For further information concerning user exits f see 
"User Exits for CICS/VS Management Programs." 


Z INPUT=symbolic-name 

generates linkage in the terminal control program to a user- 
written exit routine (VTAM only) . The linkage is generated at 
the point following completion of any input event. For further 
information concerning user exits, see "User Exits for CICS/VS 
Management Programs." 


Z OUTPUT=symbolic—name 

generates linkage in the terminal control program to a user- 
written exit routine (VTAM only) • The linkage is generated for 
output events at the point prior to translating or framing 
output data. For further information concerning user exits, 
see "User Exits for CICS/VS Management Programs." 


For CICS/OS/VS only 


INITRL=YES 

specifies that all reads from other than an application program 
are with the keyboard lock option. The FEATURE=KBRDLOCK 
operand must be included in the DFHTCT TYPE=LINE macro 
instruction to have the keyboard lock feature operative for 
that line. This operand applies only to 2260 devices. 


TCM3 270=YES 

is required if TCAM support includes the 3270 Information 
Display System. 


XTCM IN=symbolic—name 

is used (for TCAM only) to generate linkage to a user—written 
exit routine. The linkage is generated following completion of 
any input event. 


XTCMOUT=symbol ic—name 

is used to generate linkage in the terminal control program 
TCAM module to a user—written exit routine. 

The linkage is generated for output events prior to placing 
data on the output queue. 


TDP — TRANSIENT DATA CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
transient data control program is DFHSG PROGRAM=TDP• Unless otherwise 
indicated, the omission of an operand results in the corresponding 
function not being included. If neither INTRA or EXTRA is specified, a 
dummy transient data program will be generated. 
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The device type for use with intrapartition transient data via DAM 
(for DOS/VS only) is specified in the DFHDCT TYPE=INITIAL macro. 


I-1-1- “T -----1 



|DFHSG 

l PROGRAM=TDP 



i 

| [,DESTRCV={NO|YES}] 



i 

| [,DUMMY=YES] 



i 

| [,EXTRA= ({ACQUISITION|,DISPOSITION}) ] 




| [ ,INTRA= ([ YES][ , (DAM | BDAM1VSAM1 ][ , TRANSINIT ]) ] 



i 

| [ ,STAQE2 2 = {SELECTIVE | FORCE) ] 



i 

| [ # SUFFIX=xx] 



i 

| [,XINPUT==symbolic—name] 




| [ , XOUTPUT=symbolic—name ] 


«- 

i 

i 

| [ # XTYPREQ=symbolic—name ] 

i___ 

—_i 


PROGRAM=TDP 

indicates that the transient data control program is to be 
generated. 


DESTRCV=NO|YES 

indicates whether support is to be included to enable emergency 
restart or dynamic transaction backout of intrapartition 
transient data destinations specified as recoverable in the 
destination control table. The default is DESTRCV—NO. 

NO 

indicates that this support will not be generated. 

YES 

indicates that the support will be included for transient 
data recovery. See the description of "Generating 
Recovery/Restart Support" later in this chapter, and in 
Chapter 4.8. 


DUMMY=YES 

specifies that a dummy transient data control program is to be 
generated. 

This operand is used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy transient data control program. 
Any other operands which may have been included in the DFHSG 
PROGRAM=TDP macro instruction are ignored. 


EXTRA=ACQUISITION(DISPOSITION 

specifies that extrapartition data sets are to be used. 

ACQUISITION 

indicates input from an extrapartition data set. 
DISPOSITION 

indicates output to an extrapartition data set. 

Notes For further information concerning extrapartition data 
sets, see the section on transient data in the appropriate 
CICS/VS Application Programmer*s Reference Manual . 
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INTRA= ([ YES ][ f , DAM IBDAMIVSAM) }[, TRANSINIT ]) ] 

indicates that intrapartition queues are to be used. The 
default is INTRA=DAM. 

YES 

indicates that intrapartition queues are to be used, and is 
retained only for reasons of compatibility with previous 
releases of CICS/VS. For example, if YES is the only 
option specified, a default of DAM will be provided. 

DAM IBDAM 

indicates that the intrapartition queues are to be used 
with DAM. BDAM is provided as as alternative spelling. 

VSAM 

indicates that the intrapartition queues are to be used 
with VSAM. This option cannot be used when DAM or BDAM is 
specified. 

TRANSINIT 

indicates that intrapartition queues are to be supported 
with the automatic task initiation feature. 

For further information on intrapartition data queues, 
refer to the appropriate C ICS/VS Application Programmer's 
Reference Manual. 


STAGE2=SELECTIVE|FORCE 

may be u$ed to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 


FORCE 

forces generation of all Stage 2 jobs for this program. 
Note ; Stage 2 jobs will always be produced for this program. 


SUFFIX=xx 

provides a one— or two—character suffix (other than NO or DY 
which are reserved) for the transient data control program 
being assembled. If this operand is omitted, a suffix is not 
provided. 


XlNPUT=symbolic-name 

generates linkage in the transient data control program to a 
user-written exit routine. The linkage is provided before the 
acquisition of data in response to an input request. This exit 
is for intrapartition destinations only. For further 
information concerning user exits, see "User Exits for CICS/VS 
Management Programs" in Chapter 6.2 of this manual. 
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XOUTPUT=symbolic—name 

generates linkage in the transient data control program to a 
user-written exit routine. The linkage is provided after 
locating the appropriate entry in the destination control table 
pCT) but prior to writing data in response to an output 
request. This exit is for intrapartition destinations only. 

For further information concerning user exits, see "User Exits 
for CICS/VS Management Programs. “ 


XTYPREQ=s ymbol ic—name 

generates linkage in the transient data control program to a 
user—written exit routine. The linkage is provided prior to 
determining what type of request for transient data services 
was issued. For further information concerning user exits, see 
"User Exits for CICS/VS Management Programs." 


TRP — TRACE CONTROL PROGRAM 


The trace control program (DFHSG PROGRAM=TRP) is used for program 
maintenance and performance tuning. Used in conjunction with the trace 
utility program, this feature provides for easy use of CICS/VS trace 
facilities. 


1- 

1 

1- 

|DFHSG 

— r 
1 

PRO GRAM=TRP 

-1 

1 

i 

1 

[,AUX={NO|YES} ] 


1 


1 

[,DUMMY=YES ) 


1 

i 

1 

[,STAGE2={SELECTIVE|FORCE} ] 


1 

1 

i 

i 

1 

i 

[,SUFFIX=xx) 


1 

1 

i 

i 

1 

1 

i 

1 

For DOS/VS only 


1 

1 

1 

i 

1 

i 

[.DEVADDR-f0 0 91nnniJ 


1 1 

i 

i 

[,DEVICE={TAPE|2314|3330|3340|3350}] 



i-1_i_i 


PROGRAM=TRP 

indicates that the trace control program is to be generated. 


AUX—NO|YES 

specifies whether the optional feature of writing CICS/VS trace 
entries on a QSAM data set is to be generated. The default is 
AUX=NO. 

NO 

indicates that support for writing trace entries is not to 
be included. 

YES 

indicates that support for writing trace entries is to be 
included in addition to support for a main storage trace 
table. 


DUMMY=YES 

specifies that a dummy trace control program is to be 
generated. 
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STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 

FORCE 

forces generation of all Stage 2 jobs for this program. 

Note : Stage 2 jobs for this program will always be produced in 
CICS/DOS/VS. 


SUFFIX=xx 

provides a one— or two-character alphanumeric suffix (other 
than DY which is reserved) for the trace control program being 
assembled. If this operand is omitted, a suffix is not 
provided• 


For CICS/DOS/VS only 


DEVADDR = nnn 

specifies, for DEVICE=TAPE only, the DOS/VS device address to 
be assigned to the tape drive. It should be a three-digit 
decimal number with leading zeros, if necessary. For example, 
if SYS008 is the device address to be used, DEVADDR=008 must be 
specified. The default is DEVADDR=009. If the DEVICE=2314, 
3330, or 3340 operand is used, the DEVADDR value is picked up 
from the label information supplied for the auxiliary trace 
data set. 


DEVICE=device 

specifies the type of output device. A particular trace 
control program in CICS/DOS/VS will support only one type of 
output device. If different device types are to be used on 
different runs, more than one trace control program must be 
| generated using the SUFFIX operand. The default is the device 

| type specified or defaulted in DFHSG TYPE=INITIAL• 


TSP — TEMPORARY STORAGE CONTROL PROGRAM 

The system generation macro instruction necessary to generate the 
temporary storage control program is DFHSG PROGRAM=TSP. Unless 
otherwise indicated, the omission of an operand results in the 
corresponding function not being included. 

Note : The temporary storage program must be generated if the interval 
control program is used to store data. 
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1- 

1- 

i- 

- , 


|DFHSG 

| PROGRAM=TSP 




| r.AUX= fYES1NOIKEC1 1 



i 

| [ ,DUMMY=YES] 



i 

| [,STAGE2={SELECTIVE|FORCE} ] 



i 

f [,SUFFIX=xx] 




| [,XINPUT=symbolic—name] 




| [,XOUTPUT=symbolic—name ] 


1-- 

i 

■ 

| [,XTYPREQ=symbolic—name] 

1 

—_1 


PROGRAM=T S P 

indicates that the temporary storage control program is to be 
generated• 


AUX=YES|NO|REC 

specifies whether auxiliary storage is to be supported. The 
default is AUX=YES. The AUX=NO option can be useful for 
generating a development or test system. It provides an 
operational convenience by eliminating the need to define data 
space and data sets for temporary storage. 

YES 

indicates that auxiliary storage support is to be 
generated. 

NO 

indicates that no auxiliary storage support is to be 
generated and that temporary store write requests will 
store data in main storage regardless of the STORFAC 
parameter specified in the user f s request. AUX=NO must be 
specified if VSAM=NO was specified in the DFHSG 
TYPE=INITIAL macro. 


REC 

indicates that auxiliary storage support is to be generated 
and that certain auxiliary temporary storage identifiers, 
as defined in the temporary storage table (TST) , will be 
recoverable. That is, they will be restored by the 
emergency restart and dynamic transaction backout functions 
in the event of a transaction or system failure. 


DUMMY=YES 

specifies that a dummy temporary storage program is to be 
generated. 

This operand may be used instead of the DFHSG PROGRAM=CSD macro 
instruction to generate a dummy temporary storage control 
program. Any other operands which may have been included in 
the DFHSG PROGRAM=TSP macro instruction are ignored. 


STAGE2=SELECTIVE|FORCE 

may be used to override the specification or the default set by 
the STAGE2 operand of DFHSG TYPE=INITIAL for producing the 
Stage 2 jobstream for this program. 

SELECTIVE 

indicates that the Stage 2 jobstream for this program will 
be suppressed if that version of the program already exists 
on the starter system library. 
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FORCE 

forces generation of all Stage 2 jobs for this program. 


SUFFIX=xx 

provides a one— or two—character suffix (other than NO or DY 
which are reserved) for the temporary storage program being 
assembled. If this operand is omitted, a suffix is not 
provided. 


XINPUT=symbolic—name 

generates linkage in the temporary storage control program to a 
user—written exit routine. The linkage is provided prior to 
the return of control to the application program after 
servicing an input request. For further information concerning 
user exits, see "User Exits for CICS/VS Management Programs* in 
Chapter 6.2 of this manual. 
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set control blocks are defined through the combination of DFHDCT 
TYPE=INITIAL and DFHDCT TYPE=SDSCI macro instructions. 

Whether the specified destinations are extrapartition or 
intrapartition (or indirect destinations pointing to either 
extrapartition or intrapartition destinations) , the symbolic names of 
the destinations must be provided by the user. CICS/VS uses several 
intrapartition destinations for its own purposes. These entries must be 
included in the generation of the DOT. Refer to Appendix A for details 
of the required entries. 


CONTROL SECTION — DFHDCT TYPE=INITIAL 


The entry point and beginning address for the destination control table 
being defined are established by the DFHDCT TYPE=INITIAL macro 
instruction. 


i - 1 - 1 - 1 

| |DFHDCT | TYPE=INITIAL | 

| | | [,INDEX={NOtYES} ] | 

| | | r ,SEPASMB= fNOIYES) 1 | 

| | | [,SUFFIX=Xx] | 

| | | [ ,TRNSUFX= (xx[ # xx],...) ] | 

I I I I 

| f | For DOS/VS only | 

III I 

| | | r,PEVICE= {2314 133301334013350} 1 I 

t_i_i___i 


TYPE=INITIAL 

establishes the control section into which the destination 
control table is assembled. 


INDEX=NO|YES 

specifies whether indexing will be used. The default is NO. 

In some circumstances, indexing reduces the number of processor 
cycles required to search CICS/VS tables by shortening the scan 
to locate entries. It also reduces the CICS/VS working set for 
large tables by reducing references to little—used or unused 
pages, or pages between the referenced entry and table start. 
For further information, refer to the appropriate CICS/VS 
System Programmer t s Guide. 

YES 

indicates that indexing will be used. When this option is 
chosen, an alphabetically ordered list of destination names 
is generated as part of the expansion of the DFHDCT 
TYPE=FINAL macro. 


NO 

indicates that indexing will not be used. 

Note s Page—indexing (the former PAGENXD operand) is no longer 
supported. However, if PAGENXD=YES is specified and the INDEX 
operand does not appear, the entries will be treated as if 
INDEX=YES were specified. 
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SEPASMB=NO|YES 

indicates whether a full destination control table is to be 
generated or whether only data set control information for 
nonresident data set definition is to be generated• The 
default is SEPASMB=NO 

NO 

indicates that a full destination control table is to be 
generated with data set control information. 

YES 

indicates that only the DFHDCT TYPE=INITIAL , DFHDCT 
TYPE=SDSCI, and DFHDCT TYPE=FINAL macro instructions are 
are to be included in this destination control table. This 
option does not generate a full destination control table. 
For further information on the use of the SEPASMB=YES 
option, refer to the section on “Nonresident Data Set 
Definition* at the end of the description of the 
destination control table. 


SUFFIX=xx 

specifies a one— or two—character alphanumeric suffix (other 
than “NO* which is reserved) for the destination control table 
being assembled. This suffix, if specified, is appended to the 
standard module name (DFHDCT) and is used to name the module on 
the linkage editor output library. If this operand is omitted, 
a suffix is not provided. 


TRNSUFX=xx 

specifies a list of one— or two-character alphanumeric suffixes 
associated with nonresident data set control blocks. Any 
suffix appearing subsequently in the SUFFIX operand of the 
DFHDCT TYPE=SDSCI macro instruction must also appear in this 
list. These suffixes are used to punch the control cards for 
the linkage-editor (LNKEDT) . Up to 255 suffixes can be 
specified. 

Note : During link—edit of DFHDCT, there is one unresolved 

ADCON in each phase created under the direction of TRNSUFX in 
DFHDCT TYPE-INITIAL. This message does not imply an error. 


For DOS/VS Only 


DEVI CE=devi ce 

specifies the type of device on which the DAM intrapartition 
data set resides. The default is DEVICE=2314. This operand 
replaces the DEVICE operand that was formerly in DFHSG 
PROGRAM=TDP. 

| Note : If DFHSG FR0GRAM=TDP is generated with INTRA=VSAM, the 

I device type specified in this operand will be ignored at 

I execution time and need not be specified. The default of 

| DEVICE—2314 will nevertheless be applied and the resulting 

| MNOTE can be ignored. 
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EXTRAPARTITION DESTINATIONS — DFHDCT TYPE=EXTRA 


Destinations external to the CICS/VS system (but which are allocated to 
CICS/VS) are specified in the DFHDCT TYPE=EXTRA macro instruction. This 
macro instruction must be generated once for every extrapartition 
destination. 

Destinations that are not allocated to this CICS/VS system but which 
are required for access by this CICS/VS system in an intersystem 
communication session are defined to be in another CICS/VS system 
through the DFHDCT TYPE=REMOTE macro , which appears later in the 
discussion of this table. 

Extrapartition destinations which use nonresident data set control 
blocks are not required to be associated with a specific data set 
definition. When such destinations are opened, a one— or two—character 
suffix must be supplied to the dynamic open/close program that indicates 
which nonresident data set control blocks are to be used for the 
destinations. 

Notes 2 

1. The DFHDCT TYPE=INDIRECT macro instruction should be used when 
multiple extrapartition destinations are directed to the same data 
set. 

2. Any destination identification PESTID) of more than four 
characters is truncated on the right. The name should not start 
with the letter "C*, which is reserved for CICS/VS. This applies 
to DFHDCT TYPE=EXTRA, TYPE=INDIRECT, and TYPE=INTRA• Refer to 
Appendix A for a listing of the required destination identification 
entries. 


i-1-1-1 

| |DFHDCT | TYPE=EXTRA | 

j | | ,DESTID=name j 

| j j [,DSCNAME=name] j 

| | | r rOPEN— fINITIAL \ DEFERRED] 1 | 

| | | [ ,RESIDNT={YES |N0} ] | 

i-1-1_____i 


TYPE=EXTRA 

indicates extrapartition destinations. 


DESTID=name 

specifies the symbolic name of the extrapartition destination. 
The symbolic name is the same as that used in the transient 
data operations to specify the destination. 


DSCNAME=name 

specifies the data set name the user must include in the DFHDCT 
TYPE=SDSCI macro instruction for destinations that use resident 
data set control blocks. This operand is not applicable for 
destinations that use nonresident data set control blocks. 
Nonresident data set control blocks are identified when the 
destination is opened. 
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OPEN =INITIAL | DEFERRED 

specifies how the data set associated with this destination is 
to be opened. The default is OPEN=INITIAL. This operand 
applies only to extrapartition destinations which use resident 
data set cgntrol blocks. 

INITIAL 

indicates that the data set is to be opened during system 
initialization. 

DEFERRED 

indicates that the user will open the data set during 
execution of CICS/VS. 


RESIDNT=YES f NO 

indicates whether this destination is to use resident or 
nonresident data set control blocks. The default is 
RESIDNT=YES. 

YES 

indicates resident data set control blocks. 

NO 

indicates nonresident data set control blocks. 

Those CICS/DOS/VS extrapartition data sets which are closed and 
reopened by the dynamic open/close function of the master 
terminal program must be defined as nonresident, or 
unpredictable results may occur. See "Nonresident 
Extrapartition Data Set Definition" below. 


INDIRECT DATA DESTINATIONS — DFHDCT TYPE^INDIRECT 


Indirect data destinations can be specified within the destination 
control table using the DFHDCT TYPE=INDIRECT macro instruction. The 
indirect data destination does not point to an actual data set but 
| instead points to another destination. This may be an extrapartition, 

| an intrapartition, or a remote destination, or another indirect 
| destination. 

For example, assume that the user develops functional symbolic names 
for the destinations of several message types. These, in turn, may 
point to one actual destination. At a later time the user might choose 
to direct one of the message types to another destination. The user 
does not change the programs but only alters the indirect destination 
name. 


i-1-r—- 

| |DFHDCT | TYPE=INDIRECT 

| | | ,DESTID=name 

| | | ,INDDEST=name 

i-1_i___1___!__ 


l 

I 

I 

I 

J 


TYPE=INDIRECT 

indicates an indirect destination. 
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DESTID=name 

specifies the four—character symbolic name of a particular 
indirect destination. The symbolic name is the same as that 
used in the transient data operation. 


INDDEST=name 

specifies the symbolic identification of an intrapartition or 
extrapartition destination. This identification must be the 
same as the DESTID of the actual destination. If the name 
specified is not defined in the DCT, an assembly error will 
result. 


INTRAPARTITION DESTINATIONS — DFHDCT TYPE=INTRA 


Destinations for messages that are to be logged temporarily by CICS/VS 
are specified using the DFHDCT TYPE=INTRA macro instruction. This macro 
instruction must be specified once for every intrapartition destination. 



1- 

|DFHDCT 

~r 

1 

TYPE=INTRA 

-1 


i 

1 

,DESTID=name 



i 

1 

r »DESTFAC={TERMINAL 1 FILE! 1 



i 

1 

[,DESTRCV={NO|PH|LG}] 



i 

1 

1 

[ ,REUSE= {YES | NO) ] 

[,TRANSID=name] 



i 

i_ 

1 

-L. 

[ # TRIGLEV={1Inumber} ] 

_____ _> 


TYPE=INTRA 

indicates an intrapartition destination. 


DE STID=name 

specifies the symbolic name of the intrapartition destination. 
The symbolic name is the same as that used in the transient 
data operation to specify the destination. 

If the ultimate destination of the data is a terminal and if 
automatic task initiation is associated with the destination, 
the name specified in the DESTID operand must be the same as 
the name specified in the TRMIDNT operand of the DFHTCT 
TYPE=TERMINAL macro instruction. The user may find it 
convenient to use the same naming convention for terminal 
destinations and data set destinations, regardless of whether 
automatic task initiation is requested. 


DE STFAC =TERMINAL |FILE 

specifies the type of destination that the queue represents. 
The default is DESTFAC=TERMINAL• 

TERMINAL 

indicates that the transient data destination is to be 
associated with a specific terminal. If the automatic 
initiation facility is used, as specified in the TRANSID 
and TRIGLEV operands, the transaction initiated will be 
associated with the specified terminal, which must be 
available before the transaction can be initiated. 
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FILE 

indicates that the transient data destination is to be used 
as a file of data records which are not associated with a 
particular terminal. Automatic task initiation does not 
require a terminal to be available. 


DESTRCV=NO|PH|LG 

indicates the recoverability attributes of the destination in 
the event of an abnormal termination of CICS/VS. The default 
is DESTRCV*=NO. 


NO 

indicates that this destination is not recoverable and that 
automatic logging is not to be performed to keep track of 
accesses to this destination. 

PH 

indicates that this destination is physically recoverable 
and that automatic logging is to be performed to keep track 
of accesses by application programs. In the event of 
emergency restart, this destination is to be recovered to 
its status at the time CICS/VS terminated. 

LG 

indicates that this destination is logically recoverable 
and that automatic logging is to be performed to keep track 
of accesses by application programs. If a transaction 
which had accessed this destination was in-flight at the 
time of abnormal termination, in the subsequent emergency 
restart or dynamic transaction backout this destination is 
to be restored to the status it would have had if the in¬ 
flight transaction had not modified it. 

Notes: 


| 1. In the following notes and in the description of the REUSE 

| operand (below) , intrapartition storage is referred to as 

| tracks. When intrapartition data is processed under VSAM, 

| the storage is allocated in control intervals}, when it is 

| the VSAM control intervals that may be defined as being 

| reuseable. 


2. If the destination is specified with REUSE=YES and 
DESTRCV=NO, a track is released as soon as the last record 
on it has been read. 

3. When REUSE=YES and DESTRCV=PH are specified for a 
destination, a track is released during the next GET after 
the GET which read the last record. 

4. For REUSE=YES and DESRCV=LG, a track is not released until 
the end of the task, or until after the next user—specified 
sync point. 
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5. If DESTRCV=LG is specified, when this destination is 

accessed, the record being read or written will be enqueued 
upon. This enqueue will be maintained until the task 
terminates or issues a DPHSP macro to signal the end of a 
logical unit of work. This is necessary to ensure the 
integrity of the data being accessed. Because the enqueues 
are thus maintained for a longer period of time, the 
potential for an enqueue lockout exists if an application 
program that accesses this destination perfprms what is 
effectively more than one logical unit of work against it 
without defining each separate logical unit of work to 
CICS/VS by issuing the sync point request. Furthermore, 
when a PURGE request is issued for a logically recoverable 
queue, the input and output ends of the queue are enqueued 
upon. This increases the probability of an enqueue 
lockout. 


REUSE=YES|NO 


specifies whether the storage tracks are to be reused, 
default is REUSE=YES• 


The 


YES 

indicates that intrapartition storage tracks for this 
destination are to be released after they have been read, 
and returned to the pool of available tracks after the 
logical unit of work which read them has terminated. 


indicates that intrapartition storage tracks for this 
destination are not to be released until a transient data 
purge request is issued; this causes all tracks associated 
with this DESTID to be released. If DESTRCV=LG is 
specified, tracks will not be released until the next sync 
point; otherwise tracks are released immediately. 
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DFHFCT TYPE=DATASET, TABLE ENTRY FOR A VSAM * 

DATASET=VSAM1, KSDS DATA SET * 

ACCMETH= (VSAM, KSDS) , * 

SERVREQ= (GET,PUT,UPDATE,DELETE,NEWREC) , * 

FILSTAT= (ENABLED,OPENED) , * 

RECFORM=FIXED, * 

BUFSP=50000 r * 

BUFNI=1G, * 

BUFND=11, * 

STRNO=10, * 

PASSWD=LETMEIN 


Figure 3.2-5 (Part 1 of 2) . File Control Table VSAM KSDS Example 


DFHFCT TYPE=DATASET, TABLE ENTRY FOR A VSAM * 

DATASET=VSAM2, ICIP KSDS DATA SET * 

ACCMETH= (VSAM, KSDS) , * 

SERVREQ= (GET,PUT,UPDATE) , * 

FILSTAT= (ENABLED,OPENED) , * 

RECFORM=FIXED, * 

BUFSP=50000, * 

BUFN1=8, * 

STRNO=15, * 

PASSWD=LETMEIN, * 

MODE= (ICIP) , * 

INDEX= (VSAMIND1,1,INIT) , * 

DATA=VSAMDAT1 


Figure 3.2—5 (Part 2 of 2). File Control Table ICIP KSDS Example 

Figure 3.2—6 illustrates the coding required to generate a VSAM mixed 
mode file. Two consecutive DFHFCT macros are required, as followst 


DFHFCT TYPE=DATASET, DEFINES THE VSAM CHARACTERISTICS* 


DATASET= VSAM3, OF A VSAM MIXED MODE FILE TO BE * 

ACCMETH= (VSAM, KSDS) , OPENED INITIALLY IN ICIP MODE * 
SERVREQ= (GET,PUT,UPDATE,DELETE,NEWREC) , * 

FILSTAT= (ENABLED,OPENED) , * 

RECFORM=FIXED, * 

BUFSP=50 000, * 

BUFNI=10, * 

STRNO=10, * 

PASSWD=LETMEIN, * 

MODE= (ICIP,MIXED) 

DFHFCT TYPE=ALTERNATE, DEFINES THE ICIP CHARACTERISTICS * 

DATASET=VSAM3, OF A VSAM MIXED MODE FILE * 

ACCMETH=(VSAM,KSDS) , * 

SERVREQ= (GET,PUT,UPDATE) , * 

FILSTAT= (ENABLED,OPENED) , * 

RECFORM=FIXED, * 

BUFSP=50000, * 

BUFNI=8, * 

STRNO=15, * 

PASSWD=LETMEIN, * 

INDEX= (VSAMIND2,1, DYN) , * 

DATA=VSAMDAT2 
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Figure 3.2—6. File Control Table VSAM and ICIP Definition of a Mixed 
Mode File 

JCT — JOURNAL CONTROL TABLE 


The journal control table (JCT) is the means by which the user describes 
journal data sets or files and their characteristics to CICS/VS for 
access through journal management. The JCT contains control information 
and operating system control blocks describing each of the journal 
files. For DOS/VS, the appropriate IOCS modules are assembled in the 
JCT. 


CONTROL SECTION - DFHJCT TYPE=INITIAL 


The control section into which the journal control table is assembled is 
established by the DFHJCT TYPE=INITIAL macro instruction. This macro 
instruction must be coded as the first statement in the source deck used 
to assemble the journal control table. 


r 


I 

I 

L. 


r 


r 


tDFHJCT | TYPE=INITIAL 
| | [,SUFFIX=XX] 

i_i_ 


l 

I 

I 

j 


TYPE=INITIAL 

establishes the control section into which the journal control 
table is assembled. 


SUFFIX=xx 

is a one— or two-character alphameric suffix for the journal 
control table being assembled. This suffix, if present, is 
appended to the standard module name (DFHJCT) which is used to 
name the module on the linkage—editor output library. 


JOURNAL ENTRIES - DFHJCT TYPE=ENTRY 


Each journal referred to during CICS/VS execution must have a JCT entry 
as generated by the DFHJCT TYPE=ENTRY macro instruction. Chapter 4.6 of 
this manual contains tutorial information concerning the choice of 
operands and values for the JCT. 
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i-1-1-—-1 

| DFHJCT | TYPE=ENTRY | 

| | ,JFILEID={SYSTEM|nn} | 

| I ., BUFSIZE=nnnnn | 

| | [ , BUFSUV==nnnnn ] | 

| | [ ,JOUROPT= ([ CRUCIAL ][ ,PAUSE ][ , INPUT ][ , RETRY ]) ] | 

| | f # JTYPE= fTAPEl |TAPE21 DISKI I DISK2} 1 | 

| | [,0PEN=[INITIAL|DEFERRED}] | 

| | f # SYSWAIT= fSTARTIO IASIS] 1 | 

| | For DOS/VS only | 

III I 

| | [ ,DEVADDR= (SYSnnn[ ,SYSmmra]) ] | 

| | f,JDEVICE= [TAPE I 2314 I 3330 I 3340|3350} 1 | 

i-1_i---1 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 


JFILEID=SYSTEM|nn 

specifies the journal file identification for this entry. 
SYSTEM 

indicates that the journal being defined is the CICS/VS 
system log. This log is required if CICS/VS is to perform 
automatic logging of changes to CICS/VS resources to 
support the emergency restart facility. In this case, 
JOUROPT= (CRUCIAL,INPUT) must be specified. The CICS/VS 
system log must have an associated BUFSIZE value of at 
least 1100 bytes if DL/I is used in CICS/OS/VS. 


nn 

is a decimal number between 2 and 99 which identifies the 
journal ID to be used. Leading zeros are not permitted. 


BUFSIZE=nnnnn 

specifies a decimal number indicating the number of bytes to be 
used as a buffer for journal I/O operations. The minimum is 72 
and the maximum is 32767 for tape, or the maximum track 
capacity for disk devices. For CICS/OS/VS, BUFSIZE must be the 
same value as the DCB BLKSIZE• For CICS/DOS/VS, if DL/I 
logging is being done through CICS/VS journaling, the minimum 
buffer size is 1100 bytes. 


BUFSUV=nnnnn 

specifies a decimal number to be used as a buffer shift—up 
value. The value must not be greater than the value specified 
for BUFSIZE. The default is the BUFSIZE value. 


JOUROPT=option 

specifies which journaling option or options apply to the 
journal data set represented by this entry. 

CRUCIAL 

specifies that the journal data set is very important and, 
if it becomes inaccessible, CICS/VS is to be terminated. 
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PAUSE 

specifies that if volume switching is required for a disk 
journal data set, a message is sent to the console operator 
to ask when this switch may proceed• If this option is not 
specified, the alternate extent will automatically be 
reused, thus overwriting the previous journal records. 

INPUT 

specifies that input operations are to be accepted for this 
journal data set. This option must be specified if 
emergency restart is required. 

RETRY 

specifies that output I/O errors are to be retried 
automatically on a new output volume before taking the 
action indicated by the CRUCIAL option. 


JTYPE=journal—type 

specifies the type of journal data set being defined. The 
default is JTYPE=TAPE1. 

TAPE1 

is a journal data set on one tape drive. 

TAPE 2 

is a journal data set on two tape drives. 

DISKI 

is a journal data set on disk which has one extent to be 
reused when full. 

DISK2 

is a journal data set on disk which has two extents to be 
used in a flip-flop manner. 


OP EN = INITIAL | DEFERRED 

specifies whether this journal file is to be opened by system 
initialization. The default is OPEN=INITIAL. 

INITIAL 

indicates that the journal file is to be opened for output 
by system initialization. 

DEFERRED 

may be used for journals that are opened by transactions 
that are executing under CICS/VS, or by programs that are 
specified in the program list table. 

Note s If the user wants to open a journal data set during 
execution, the VOLUME=FIRST parameter must be specified in 
the DFHJC TYPE=OPEN macro (see the section "Opening a 
Journal Data Set" in Chapter 4.6) . 


SYSWAIT =STARTIO IASIS 

indicates whether I/O is to be initiated immediately on 
synchronizing requests, namely PUT, (WRITE,WAIT) , or WAIT, to 
this journal file from CICS/VS management modules. Note that 
this operand has no effect on user journaling requests. The 
default is SYSWAIT=STARTI0. 


150 


CICS/VS System Programmer*s Reference Manual 




Page of SC33—0069-2, revised August 1978 by TNL SN33—6217 


STARTIO 

indicates that I/O is to be initiated immediately on 
synchronizing requests from CICS/VS management modules to 
the journal file. This option has the same effect as 
START10=YES specified on all such requests. 


ASIS 

indicates that the option specified in the STARTIO keyword 
in the macro request is to be honored for synchronizing 
requests to the journal file from CICS/VS management 
modules. In almost all cases this will be STARTIO=NO. It 
is recommended that SYSWAIT=ASIS be specified only if the 
frequency of requests to the journal file is so high that 
the device becomes overloaded. 


For DOS/VS only 


DEVADDR=a ddr e ss 

specifies the user's logical unit address for the journal data 
set. 

SYSnnn 

specifies the logical unit address, where the nnn is a 
three-digit number from 000 to 255. 

SYSmmm 

specifies the alternate logical unit when two devices (tape 
or disk) are to be used for the journal data set. Like 
nnn, iranm is a three-digit number from 000 to 255 but cannot 
be equal to nnn. 


JDEVICE=device 

specifies the device type on which the journal data set is to 
reside. The default is JDEVICE=TAPE. 


END OF JOURNAL CONTROL TABLE - DFHJCT TYPE=FINAL 


The end of the journal control table is indicated by the DFHJCT 
TYPE=FINAL macro instruction. The assembler END statement must follow. 


i-r — --1- 

| |DFHJCT | TYPE=FINAL 

i-1__i___ 


T 


I 

J 


TYPE=FINAL 

indicates the end of the journal control table. 


EXAMPLE 

Figure 3.2—7 illustrates the coding to create a journal control table 
(JCT) for three journals: 

• The system log, allocated two tape drives 

• Journal identification 2, allocated one disk extent 
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• Journal identification 3, allocated two disk extents 

Note ; See the appropriate CICS/VS System Programmer*s Guide for 
execution—time JCL corresponding to this example. 


DFHJCT TYPE=INITIAL 

DFHJCT TYPE=ENTRY f ENTRY FOR * 

JFILEID=SYSTEM, SYSTEM LOG * 

JTYPE=TAPE2, TWO TAPE DRIVES ALLOCATED * 

BUFSIZE=1500, BUFFER SPACE IS 1500 BYTES * 

BUFSUV=1000, SHIFT UP POINT IS FULL * 

DEVADDR= (SYS004,SYS005) , LOGICAL DEVICE ADDR * 

JOUROPT= (INPUT 9 RETRY , CRUCIAL) OPTIONS 

DFHJCT TYPE=ENTRY, ENTRY FOR * 

JFILEID=2 9 JOURNAL ID 2 * 

JTYPE=DISK1 t ONE DISK EXTENT ALLOCATED * 

BUFSIZE=1500, BUFFER SPACE IS 1500 BYTES * 

BUFSUV=1500, AND •SHIFT-UP* WILL NEVER OCCUR * 

JDEVICE=3330, JOURNAL DEVICE * 

DEVADDR=SYS006, LOGICAL DEVICE ADDR * 

JOUROPT=RETRY OPTIONS 

DFHJCT TYPE=ENTRY, ENTRY FOR * 

JFILEID=3, JOURNAL ID 3 * 

JTYPE=DISK2 , TWO DISK EXTENTS ALLOCATED * 

JOUROPT= (PAUSE,RETRY) , OPTIONS * 

JDEVICE=2 314, JOURNAL DEVICE * 

DEV ADD R= (S YS0 06, SYS 0 07) , LOGICAL DEVICE ADDR * 

BUFSIZE=1000 BUFFER SPACE IS 1000 BYTES * 


* SHIFT-UP VALUE DEFAULTS TO BUFSIZE * 

DFHJCT TYPE=FINAL 
END 

Figure 3.2—7. Journal Control Table — Example 


NLT — NUCLEUS LOAD TABLE 


The nucleus load table has been provided to enable the CICS/VS user to 
utilize virtual storage efficiently. The table is used by CICS/VS to 
control the load order of the CICS/VS nucleus. It allows the CICS/VS 
user the option of changing the default load order established by the 
CICS/VS system initialization program. 

The modules specified in the nucleus load table are loaded in the 
order and at the relative location specified in each DFHNLT TYPE=ENTRY 
instruction. When all specified modules have been loaded § a default 
list is used to load the remaining modules. The default nucleus load 
table is contained in the system initialization module DFHSIBl• This 
module would be a good reference for any installation considering 
altering the default list. 

The default load order for CICS/DOS/VS and CICS/OS/VS is shown below. 
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CICS/DOS/VS 


ADDRESS 

SPACE 

LOW 


MODULE 

OPTION 

FUNCTION 

DFHTCT 


Terminal Control Table 

DFHCSA 

ALIGNED 

Common System Area 

DFHKCP 

ALIGNED 

Task Control Program 

DFHEIP 


EXEC Interface Program 

DFHSPP 


Sync Point Program 

DFHZCP 

ALIGNED 

Terminal Control Common Interface 

*DFHZCA 


VTAM Terminal Control Program 

*DFHZCB 


VTAM Terminal Control Program 

*DFHTCP 


BTAM Terminal Control Program 

DFHZCX 


BTAM and VTAM Terminal Control Program 

♦DFHZCY 


VTAM Terminal Control Program 

♦DFHZCZ 


VTAM Terminal Control Program 

DFHSCP 

ALIGNED 

Storage Control Program 

DFHPCT 

ALIGNED 

Program Control Table 

DFHPCP 

ENTRY AL *D 

Program Control Program 

DFHPPT 

ALIGNED 

Processing Program Table 

DFHFCT 

ALIGNED 

File Control Table 

♦DFHSDAM 


Direct Access Table 

DFHFCP 


File Control Program 

DFHTSP 

ALIGNED 

Temporary Storage Control Program 

♦DFHTST 


Temporary Storage Table 

DFHDCT 

ALIGNED 

Destination Control Table 

DFHTDP 


Transient Data Program 

♦DFHIIP 

ALIGNED 

Basic Mapping 

♦DFHM32 


Basic Mapping 

DFHMCP 


Basic Mapping 

♦DFHTPP 


Basic Mapping 

♦DFHDSB 


Basic Mapping 

♦DFHPBP 


Basic Mapping 


CICS/VS DYNAMIC STORAGE AREA 
AND 


CICS/VS 

APPLICATION 

PROGRAM AREA 

♦DFHTRT 

HIGH 


Trace Table 

DFHTRP 

AL *D 

HIGH 

Trace Control Program 

DFHFDP 

AL'D 

HIGH 

Formatted Dump Program 

DFHSCR 

AL'D 

HIGH 

Storage Control Recovery 

DFHKPP 

AL'D 

HIGH 

Keypoint Program 

*DFHSRT 

HIGH 


System Recovery Table 

DFHSRP 

AL'D 

HIGH 

System Recovery Program 

♦DFHMGT 

HIGH 


Message Table 

*DFHMGP 

AL'D 

HIGH 

Message Program 

*DFHISP 

HIGH 


Intersystem Communication Program 

♦DFHXFP 

HIGH 


Intersystem Transformer Program 

♦DFHELR 

AL'D 

HIGH 

Intersystem EXEC Local/Remote Program 

DFHLFO 

HIGH 


LIFO Storage Program 

DFHDIP 

AL'D 

HIGH 

Batch Data Interchange Program 

DFHDCP 

AL'D 

HIGH 

Dump Control Program 

♦DFHSAP 

AL'D 

HIGH 

Storage Acquisition Program 

DFHBFP 

AL 'D 

HIGH 

Built-In Functions 

♦DFHRLR 

AL'D 

HIGH 

Basic Mapping Route List 

*DFHF2P 

HIGH 


Faster COMPAT 
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ADDRESS MODULE OPTION FUNCTION 

SPACE 


HIGH 


♦DFHFIP 

*DLZNUC 

♦DFHJCOCP 

♦DFHJCT 

DFHJCP 

DFHICP 

DFHALT 


AL*D HIGH 
AL'D HIGH 
HIGH 
HIGH 

AL*D HIGH 
AL # D HIGH 
HIGH 


Faster COMPAT 
DL/I Nucleus Module 
Journal Open/Close 
Journal Control Table 
Journal Control Program 
Interval Control Program 
Application Load Table 


For CICS/OS/VS, the modules are loaded from high address space to low 
address space. The default load order is as follows: 


CICS/OS/VS 


ADDRESS MODULE OPTION FUNCTION 

SPAC E 

HIGH 



DFHCSA 

ALIGNED 

Common Systems Area 

1 

DFHEIP 


EXEC Interface Program 


DFHKCP 

ALIGNED 

Task Control Program 

1 

♦DFHKCSP 


HPO Task Control Module 

1 

♦DFHZHPRX 

HPO VTAM Authorized Path Interface Module 


DFHSPP 


Sync Point Program 


DFHICP 

ALIGNED 

Interval Control Program 


DFHZCP 


Terminal Control Common Interface Program 

1 

DFHZCA 


VTAM Terminal Control Program 

1 

DFHZCB 


VTAM Terminal Control Program 

1 

DFHZCX 


BTAM and VTAM Terminal Control Program 

1 

DFHZCY 


VTAM Terminal Control Program 

1 

DFHZCZ 


VTAM Terminal Control Program 


♦DFHTCP 


Terminal Control Program (non-VTAM) 


DFHTCT 


Terminal Control Table 


DFHSCP 

ALIGNED 

Storage Control Program 

1 

DFHALT 


Application Load Table 

1 

DFHLFO 


LIFO Storage Program 

1 

DFHELR 

ALIGNED 

EXEC Local/Remote Program 

1 

DFHXFP 


ISC Transformer Program 

1 

DFHISP 


Intersystem Communication Program 


DFHJCP 


Journal Control Program 


♦DFHJCT 


Journal Control Table 


DFHPCT 


Program Control Table 


DFHPCP 

ENTRY AL“D 

Program Control Program 


DFHPPT 


Processing Program Table 


DFHFCP 


File Control Program — common subroutines 


DFHFCD 


File control module for ISAM/BDAM 


♦DFHFCT 


File Control Table 


♦DFHDLI 


DL/I Interface Program 


♦DFHDMB 


DMB Directory (DL/I) 


♦DFHPSB 


PSB Directory (DL/I) 


DFHTSP 


Temporary Storage Program 


♦DFHTST 


Temporary Storage Table 


DFHTDP 


Transient Data Program 


♦DFHDCT 


Destination Control Table 


♦DFHIIP 


Basic Mapping 


♦DFHFIP 


FASTER/Compat Program 


♦DFHM32 


Basic Mapping 3270 


DFHMCP 


Basic Mapping Control 


♦DFHTPP 


Basic Mapping 


♦DFHDSB 


Basic Mapping 
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o ADDRESS MODULE OPTION FUNCTION 

SPACE 

*DFHPBP 
♦DFHRLR 
*DFHF2P 
DFHBFP 
DFHDIP 
♦DFHSAP 
DFHSCR 

| DFHMGP ALIGNED 

| DFHMGT 

DFHDCP 
DFHSRP 
| DFHCRC 

I 

*DFHSRT 
DFHKPP 

DFHFDP ALIGNED 
DFHTRP 
♦DFHTRT 

LOW 

Note s The modules listed above with a preceding asterisk (*) are not 
loaded if the facility is not specified. 

The CICS/VS default nucleus load tables are designed to give good 
performance across a wide range of applications and generation options. 
Changes to the default load order should be carefully considered, as 
improper use of the nucleus load tables can result in reduced 
performance. For example, the program control program (DFHPCP) is 
structured so that the working set instructions are at the end of the 
module following the entry point of the module. Thus, if DFHPCP is 
loaded (as in the default load order) immediately before the processing 
program table pFHPPT) and the ALIGN=ENTRY option is specified, the 
working set of DFHPCP will be loaded in the same page as the most-used 
portion of DFHPPT• This will reduce page-faults because DFHPCP uses 
DFHPPT more often than any other system table. 

The default nucleus load table attempts to provide the best working 
set arrangement for CICS/VS. However, because of the many options 
available in CICS/VS, it may be possible for an installation to improve 
on the default loading of the nucleus. Before altering the default load 
order, the system programmer should consider carefully not only the 
module to be moved but also the effect on the neighboring modules. 
Modules may be loaded adjacently because of their inter—related function 
or reference (for example, KCP and SPP). Care should be used in 
aligning modules because inadvertent choices can add to the working set 
rather than reduce it (for example, specifying ALIGN for both the PPT 
and the PCP would increase its working set) . Alignment of modules can 
be used to isolate little—used functions (for example, aligning DCP) or 
to locate the working set of a module in as few pages as possible (for 
example, aligning SCP) . 

Each installation should study its requirements carefully, and then 
use the nucleus load table (if necessary) to order the CICS/VS nucleus 
into a configuration to suit its needs. 

The purpose of the nucleus load table is to tailor the nucleus load 
to create a load order which provides the user with the smallest 
possible working set for the CICS/VS nucleus. 

The nucleus load table is an optional feature of CICS/VS. The 
nucleus load table to be used is specified in the system initialization 


Basic Mapping Page Build 

Basic Mapping Route List 

Basic Mapping FASTER/Compat 

Built-in Functions 

Batch Data Interchange Program 

Storage Acquisition Program (PL/I) 

Storage Recovery Program 

Message Program 

Message Table 

Dump Control Program 

System Recovery Program 

DL/I Shared Data Base CICS/VS STAE Exit 
Program (OS/VS only) 

System Recovery Table 
Keypoint Program 
Formatted Dump Program 
Trace Control Program 
Trace Table 
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table. If the nucleus load table specification is "NO*, the default 
load order will be used. 


CONTROL SECTION — DFHNLT TYPE=INITIAL 


The control section name for the nucleus load table is established by 
the DFHNLT TYPE=INITIAL macro instruction. This macro instruction also 
creates the necessary linkage editor control for subsequent link- 
editing. 


i-1-1—------1 

| | DFHNLT | TYPE=INITIAL | 

| | | [ , SUFFIX=xx ] | 

i_i_i____i 


TYPE=INITIAL 

establishes the control section into which the nucleus load 
table is to be assembled. 


SUFFIX=xx 

specifies a one— to two—character suffix for the nucleus load 
table being assembled. The suffix is appended to the basic 
name (DFHNLT) and used to name the module on the linkage editor 
output library. 


MODULE LOAD SEQUENCE — DFHNLT TYPE=ENTRY 


A specific nucleus module is defined to CICS/VS. Included in this 
definition is the information about where the module is to be loaded and 
the options with which the module is to be loaded. 

The DFHNLT TYPE=ENTRY macro instruction is used to specify the module 
load sequence. 


i-~~ i-i---1 

| | DFHNLT | TYPE=ENTRY v | 

| | | ,MODULE=name | 

| | | f,ALIGN=fNOIYES I ENTRY} 1 | 

| | | [ t FIX—{NO|YES}] | 

II I I 

I | | For DOS/VS Only | 

III I 

| | | r *ADRSPCE— (LOW f HIGH) 1 | 

| ( | [ ,PAGEIN= {NO | YES} ] | 

| | | f , PAGEOUT— fNO I YES} 1 | 

III I 

|| | | For OS/VS Only | 

I I I I 

III | r , (PROTECT=NOIYES1 1 | 

i-1- 1 -1 


TYPE=ENTRY 

specifies that an entry is to be specified in the nucleus load 
table. 
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MODULE=name 

specifies the nucleus module name. The name specified should 
be the basic module; suffixes are not required and will be 
ignored. 


ALIGN=N01 YES | ENTRY 

specifies whether any page alignment of th$ module is to be 
performed. Page alignment will only occur for the module (s) 
specified; all other modules will be packed in contiguous 
address space. The default is ALIGN=NO. 

NO 

specifies no page alignment. 

Note that when ADRSPCE=HIGH is specified for DOS/VS, the 
end of the module is placed at the highest available 
address• 

YES 

specifies that the beginning of the module is to be page- 
aligned to the start of a page, or that the end of the 
module is to be page—aligned to the end of a page if 
ADRSPCE=HIGH (DOS/VS only) is specified, when the module is 
loaded. (In CICS/VS Version 1, Release 2, aligned modules 
were loaded in high address space so that they started on a 
page boundary.) The current implementation allows 
infrequently used modules and tables to be packed onto the 
same page. For example, specifying DFHJCP,ALIGN=YES and 
DFHJCT,ALIGN =N0 packs the two modules onto the same page 
with DFHJCP aligned on a page boundary. 

ENTRY 

specifies that the entry point of the module will be 
aligned on a page boundary when ADRSPCE=LOW is specified. 
This is useful when the working set of the module follows 
the module entry point and the entry point is not at the 
start of the module (see the note on DFHPCP in the section 
"Nucleus Load Table" above) . 

Note : The ALIGN option should be used with care to optimize 
the size of the CICS/VS working set. Modules considered to be 
part of the normal CICS/VS working set should not normally be 
page—aligned, because page alignment may force wasted address 
space. Example: A task control program always references the 
common system area (CSA) . Packed into contiguous address 
space, this would normally occupy three 2K pages. If, however, 
both are page—aligned, four 2K pages would be used. 


FIX=NO|YES 

specifies that the module is to be page—fixed in real storage. 
Use of page—fixing should be carefully considered. Unnecessary 
page—fixing will only reduce the available real storage for 
paging and will probably adversely affect performance of both 
CICS/VS and concurrent batch work. If FIX=YES is specified, 
CICSSVC must be specified in the DFHSG TYPE=INITIAL macro. The 
default is FIX=NO. 

NO 

indicates that page—fixing is not required. 

YES 

indicates that the module is to be page—fixed. 
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Note : The options of ALIGN, PAGEIN, and PAGEOUT have no 
meaning for a module which is fixed, and will be ignored if 
this operand is specified. 


For DOS/VS only 


APRS PCE =LOW|HIGH 

specifies the partition area into which the module is to be 
loaded. LOW is the default. 

LOW 

specifies that the module is to be loaded at the low end of 
the partition. Modules normally included in the CICS/VS 
working set should be loaded low to optimize use of the 
page data set (examples are DFHKCP, DFHTCP, and DFHCSA)• 

HIGH 

specifies that the module is to be loaded at the high end 
of the partition. Modules not normally to be included in 
the CICS/VS working set should be specified to be loaded 
high (examples cure DFHDCP and DFHSRP) . 


PAGE IN=NO| YES 

indicates whether the module is to be added to a page—in list. 
The page—in list will be used to initiate a page—in operation 
each time CICS/VS regains control after a DOS/VS WAIT initiated 
by the task control program (KCP) . The default is PAGEIN=NO. 

NO 

indicates that the module is not to be added to a page—in 
list. 


YES 

indicates that the module will be added to a page-in list. 

Note : PAGEIN may be very useful in a low message rate system 

with concurrent batch operation, and all of the CICS/VS 
critical working set should be included. However, in a 
dedicated system, PAGEIN will cause additional processor 
utilization and its use should be avoided. 

Use of PAGEIN in a very active CICS/VS (high message rate) 
system should be carefully evaluated. 

PAGEIN=YES may not be specified for modules specified with 
ADRSPCE=HIGH• 


PAGEOUT=NO|YES 

indicates whether the module is to be included on a page-out 
list. The page-out list will be used by the task control 
program to initiate page-out operations immediately before 
issuing a DOS/VS WAIT. This will make those pages available 
for use by concurrent batch jobs. The default is PAGEOUT=NO. 

NO 

indicates that the module is not to be added to a page-out 
list. 
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YES 

indicates that the module will be added to a page-out list. 

Note : Normally, only those modules not considered part of the 
CICS/VS working set should be included on the page-out list 
(examples are DFHDCP, DFHSRP , and DFHSCR) . The trace program 
and table should not specify PAGEDUT=YES, because if trace is 
activated, these programs become highly referenced. 


| For OS/VS only 


PROTECT=NO|YES 

indicates, for OS/VS2 Release 3.7 (MVS) only, that the module 
is to beloaded into a protected area of storage for a CICS/VS 
system that supports VSAM ICIP, VTAM authorized path, or both. 
The default is PROTECT=NO. 

NO 

indicates that the module is not to be loaded into 
protected storage. 

YES 

indicates that the module is to be loaded into a protected 
area of storage, and is to be used for CICS/VS nucleus 
modules that run in SRB mode. The SRBSVC operand must be 
specified in DFHSG TYPEfINITIAL. 

The default nucleus load table in the system initialization 
module (DFHSIB1) has the PROTECT=YES option coded for 
DFHKCSP and DFHZHPRX; it is set dynamically in DFHSIB1 for 
DFHFCP if VSAM ICIP is used. Modules for which PROTECT=YES 
is specified do not reside in the CICS/VS user storage 
area. 


END OF NUCLEUS LOAD TABLE — DFHNLT TYPE=FINAL 


The end of the nucleus load table is indicated by the DFHNLT TYPE=FINAL 
macro instruction, which is the last statement in the assembly of the 
nucleus load table before the assembler END statement. This macro 
creates a dummy entry to signal the table—end. 

i i i .. . . ■ ^. 1 ' " . • .i 

| |DFHNLT | TYPE=FINAL | 

i_—_i-1---1 


TYPE=FINAL 

indicates the end of the nucleus load table. 


EXAMPLES 


In general, CICS/DOS/VS installations should place unused or little—used 
pageable modules into the high address space of the partition. With 
only the heavily—used programs in low address space, the seek—time on 
the page data set for these modules will be reduced. This is due to the 
organization of the page data set in DOS/VS. 
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Example 1 illustrates a nucleus load table (Figure 3.2—8) for an 
installation with the following characteristics! 

• Some CICS/VS services are not used (journal control program, 
interval control program, built-in functions, and keypoint 
program) . 

• Some CICS/VS services (transient data control and dump control 
programs) are used only for error conditions or for a small 
percentage of application programs. 

• Trace program facilities normally off. 

• Concurrent batch processing. 

The entry for the DFHSDAM with ADRSPCE=HIGH indicates (for CICS/DOS/VS 
only) the assumption that no direct access files cure defined in the file 
control table (FCI^ . 


CICS/VS System Programmer's Reference Manual 


158.2 



Page of SC33—00 69— 2 , revised August 1978 by TNL SN33—6217 


AKP 

generates TRANSID=CSKP for the activity keypoint program, 

ATP 

provides the transaction identifications associated with 
the asynchronous transaction processing facility. The 
transaction identifications generated are: 


• CAQP — asynchronous purge queue 

• CATP — asynchronous transaction control program 

• CRDR — ATP input processor 

• CWTR — ATP output processor 


AUTOSTAT 

generates TRANSID=CAUT for the automatic statistics 
summarization utility. 

BMS 

generates the following identifications for transactions 
running under BMS: 


• CSPG — terminal page retrieval 

• CSPQ — terminal page clean—up 

• CSPS — delayed message delivery 


CONSOLE 

generates TRANSID=CWTO for processing unit console support 
in CICS/DOS/VS. 

FE 

generates TRANSID=CSFE for the FE terminal test facility. 
HARDCOPY 

generates TRANSID=CSPP for the 3270 print support function 
fBTAM and VTAM) . 

ISC 

generates the following transaction identications for 
intersystem communication support and DL/I shared data base 
support in CICS/OS/VS: 


• CSMI — mirror transaction 

• CSNC — DL/I inter—region new connection transaction 


JOURNAL 

generates TRANSID=CSJC for the journal tasks bootstrap 
program , and is required if journal management is being 
used. 

MASTTERM 

provides the following transaction identifications for the 
master terminal facility: 


• CSMT — master terminal functions 

• CSST — supervisor terminal functions 

• CSOT — terminal operator functions 
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MSWITCH 

generates TRANSID=CMSG for the message switching program. 
Note that the user may choose any four-character code to 
| replace CMSG. FN=MSWITCH also generates the BMS group of 

I transaction identifications. 

NUMERICS 

generates TRANSID=8888 and 9999 for numeric—only devices, 
such as the 7770, as the sign—off and sign-on transaction 
identifications. 

RESEND 

generates TRANSID=CSRS for the resend program (VTAM only) . 
RESPLOG 

generates TRANSID=CSLG for the response logging program 
(VTAM only) . 

SIGNON 

generates the transaction identifications associated with 
the sign-on program. The transaction identifications 
generated are: 


• CSSN — sign—on 

• CSSF — sign-off 


TIME 

generates TRANSID^STA for the time-of—day adjustment 
program. 


VTAM 

generates TRANSID=CSNE for the VTAM node abnormal condition 
program and CSGM for the good morning sign-on message. 

VTAMPRT 

provides the following transaction identifications 
associated with the VTAM 3270 print function: CSCY, CSPK, 
and CSRK. 


TRANSACTION DESCRIPTION OPTIONS - DFHPCT TYPE=0 PTGRP 


The DFHPCT TYPE=OPTGRP macro instruction is used to control message 
protection processing for a task executing on a VTAM-supported TCTTE. 

The parameters specified cause CICS/VS to log relevant data about the 
transaction*s terminal data during processing, and are also used for 
message resynchronization if a failure occurs. 

DFHPCT TYPE=OPTGRP macros must precede the DFHPCT TYPE=ENTRY macros that 
relate to them. 


i-j-,- 

| name |DFHPCT| TYPE=OPTGRP 

| | | [ ,MSGPOPT= (PROTECT,MSGINTEG,ONEWTE,CCONTRL) ] 

| | | [,MSGPREQ= (PROTECT,MSGINTEG,ONEWTE,CCONTRL) ] 

i_i_i_ 


name 

specifies the name of the message option group. This operand 
is required and may be any valid assembler—language name, from 
one to six characters. This is the same name that is specified 
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1- 


| [ ,SKRxxxx=*page—retrieval—command* ] 

-j 


1 

| [ .SRP= ffrfeMxx) ] 



i 

| [ ,SRT*={2g|xx|NO} 3 



i 

1 T »START={COLD 1WARM} 1 



i 

| [,SUFFIX-xx] 



i 

| [.SVD= fNO1YES|nn)] 



i 

| [ ,TCP={gg|xx|NO} 3 



i 

| [ ,TCT=<[ {g£|xx} ],[ {COLD| WARM} 3) 3 



! 

| [ ,TDP=fMzHxxl 3 



1 

| { .TPP=ffeHz<|xx{ 3 



1 

| [ ,TRP=([ (gg|xx} 3,[ {ON|OFF} },[ {ON|OFF|AUX} 3) 3 



1 

| [ ,TRT=={j)| decimal—value} ] 



1 

| [,TSMGSET={41number} ] 



1 

| [ ,TSP= ([ {^|xx|NO} },[ {COLD|WARM} 3) 3 



1 

| [»TST=fNO|YES 1XX} 3 



1 

| [ ,WRKAREA= {5121 niamber} ] 



1 

| [,XLT={NO|xx} 3 



1 

1 

| [»ZCP=fbblxx} 3 

1 



1 

1 

1 

1 For DOS/VS Only 

1 



1 

1 

| [,ICVSWT={40|decimal-value} 3 



1 

1 

j [/NSD={91number} } 

■ 



1 

l 

a 

1 For OS/VS Only 



1 

l 

| [,BUFPL={£Inumber}3 



l 

| [,DDlR=xx 3 



l 

| [,DLTHRED=[1|decimal—number}3 




| [,DMBPL={4|number}3 



l 

| [ ,ENQPL={2|n} 3 



I 

| [,IOCP={01number} } 



l 

| [,IRCSTRT={NO|YES}3 



l 

1 T.OSCOR={81921decimal—value}1 



l 

| [,PDIR=XX3 



l 

| [,PISCHD={NO|YES}3 



l 

| [,PLISHRE={NO|YES} 3 



l 

1 T #PSB= fCICSPSB1name} 1 



l 

| [,PSBPL= {4 Inumber} 3 


1 _ 

•_ 

i_ 

_ft 


Note s: 

1. When the dummy version of a module is to be included in the system 
initialization table (either while generating DFHSIT or in the 
override parameters during start—up time) , "module name* =N0 and 
not "module name" =DY should be specified, unless the function to 
be dummied has an associated table* If it does, "Table name" =N0 
should be specified and nothing need be specified for "module 
name". 

Example without table: KPP=NO or DCP=NO 
Example with table: FCT=NO or DCT=NO 


Chapter 3.2. DFHSIT 


197 







Page of SC33-0069-2, 


revised August 1978 by TNL SN33—6217 


2. The following parameter descriptions apply to the modules that 
refer to Note 2* 

1) The operand indicates that a suffixed version or a dummy module 
may be loaded. 


xx 

indicates a one— or two-character suffix which is appended 
to the standard name before loading the CICS/VS nucleus. 

For example, KCP=B1 causes the DFHKCPB1 task control module 
to be included in the CICS/VS nucleus. 

m 

In each case the default suffix is } 6 ) 6 , although these 
blanks cannot be specified in the DFHSIT macro except 
within quotes. 


indicates that a dummy module is to be loaded. For 
example, FCT=NO, SRT=NO, JCT=NO, and DCT=NO causes a dummy 
FCP, a dummy SRP, a dummy JCP, and a dummy TDP to be 
loaded, respectively. 

Note that when the suffix option is specified with other 
parameters, the two parameters must be enclosed within 
parentheses: for example, JCT= (xx,DISK) . 


2) The operand specifies the type of start that the system 

initialization program will make for that facility. The default 
is the option specified in the START operand. 

COLD 


indicates a cold start 


WARM 

indicates a warm start 

Note : Individual facilities may differ from the value 

specified in the START parameter. Example: START=COLD and 
FCT= (01,WARM} . In this case the FCT would be warm started, 
while the default for the facilities not specified is a cold 
start. 


TYPE=CSECT|DSECT 

indicates the type of system initialization table to be 
generated. The default is CSECT. 

CSECT 

indicates a regular control section and is normally used. 
DSECT 

indicates a dummy section. 

If alternate or additional system initialization modules 
are coded by the user, a DSECT may be required to provide 
symbolic addressability to values in the table. 
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ABKPOPT=NO|YES 

specifies whether keypointing is to be performed during an 
abnormal termination intercepted by the system recovery program 
(DFHSRP) . The default is ABKPOPT=NO. 


NO 

indicates that keypointing will not be used with DFHSRP. 

YES 

indicates that keypointing will be used with DFHSRP. 


AKPFREQ=decimal—value 

specifies how frequently activity keypoints are to be taken. 
If AKPFREQ=0 (which is the default) is specified, no activity 
keypoints will be taken. If AKPFREQ is a value other than 
zero, it specifies the number of consecutive write operations 
to the system log data set which will trigger the activity 
keypoint function. The range is 200 to 65535. 


ALT==NO|xx 


specifies the application load table used to control the load 
order of resident application programs. The default is ALT=NO. 


NO 

indicates that the PPT table is used to determine the load 
order of resident application programs. 

xx 

is a one- or two—character suffix that specifies which 
application load table is to be used. 


AMXT=decimal—value 

specifies the maximum number of tasks (excluding journal ' 
control tasks and the terminal control task) that CICS/VS will 
inspect during its dispatch scan; that is, the maximum number 
of tasks that CICS/VS will allow to be active concurrently. The 
value specified in the MXT operand (see below) sets a limit on 
the number of tasks that CICS/VS will initiate concurrently 
(that is, put into the active chain) . The AMXT value controls 
the number of initiated tasks that CICS/VS will consider for 
dispatching. 

This parameter is especially useful in a conversational CICS/VS 
environment where the maximum task value (MXT=) is not an 
effective tuning tool, and would normally be set higher than 
the number of concurrent tasks the system is capable of 
servicing effectively. 

The maximum active task value can be used by the conversational 
CICS/VS environment to control the load on CICS/VS without 
limiting the number of terminals in use. 

If the maximum active task value is set too low in an 
environment where tasks can wait for the completion of events 
being processed by other tasks, a lock-out situation can occur. 
It occurs mostly when one task attaches another and then waits 
for the completion of an event processed by the new task. The 
new task may be locked—out from running because of the presence 
of enough tasks of the first type to equal the maximum active 
task number. The user can prevent this situation by using a 
sufficiently high maximum active task value (AMXT) and/or a 
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class maximum task value (CMXT) , that is lower than the maximum 
active task value, on tasks which wait for events from other 
tasks. 

The default value for the number of maximum active tasks is 
equal to the maximum task value. The range is 1 to 999. 


t AP PLID =DBDCCIC S j name 

specifies a one— to eight—character application name defined to 
VTAM during VTAM system definition and identifies CICS/VS to 
| VTAM as an application program. If this operand is not 

| specified in DFHSIT, DFHTCT TYPE^INITIAL, or as a system 

| initialization override, APPLID will default to DBDCCICS. 

APPLID is also the name by which the CICS/VS system is known to 
other CICS/VS systems, including the batch system (for DL/I 
shared data base support in CICS/OS/VS) . The name specified in 
this operand should be the same as that in the NETNAME operand 
in DFHTCT TYPE=ISLINK or DFHTCT TYPE=TERMINAL for the remote 
system in an intersystem communication session. 


ATP=NO|YES|COLD\WARM 

specifies whether the asynchronous transaction processing 
facility (ATP) is to be supported. The default is ATP=NO. 

NO 

indicates that ATP support is not desired. 

YES 

indicates that ATP support is desired. 


COLD 

indicates a cold start. 

WARM 

indicates a warm start. 


ATPMB=number 

specifies, as a decimal value, the asynchronous task inhibitor 
value. When the number of active tasks (both synchronous and 
asynchronous) reaches this level, the asynchronous transaction 
processing control program (DFHATP) does not initiate any new 
asynchronous tasks, even though the number of asynchronous 
tasks currently active is less than the value specified in the 
ATPMT operand. Thus, even though no asynchronous tasks are 
active, none are initiated if the total of all other active 
tasks has reached the level specified in this operand. The 
default value is equal to one less than the value specified in 
the MXT operand. The range is 1 to 998. ATPMB must be less 
than MXT. 


ATPMT=number 

specifies, as a decimal value, the maximum number of 
asynchronous tasks that can be initiated concurrently within 
CICS/VS by the asynchronous transaction processing control 
program (DFHATP) . When the number of active asynchronous tasks 
reaches this level, no new asynchronous tasks are initiated by 
DFHATP. The default is ATPMT=1. The range is 1 to 998. ATPMT 
must be less than or equal to ATPMB. 


200 


CICS/VS System Programmers Reference Manual 



Page of SC33—0069—2, revised August 1978 by TNL SN33—6217 


YES 

indicates that the TST table is to be included (this must 
be specified if the temporary storage program is generated 
with AUX—REC or if intersystem communication support is 
required) . 


xx 

indicates the 2—character suffix appended to DFHTST. 


WRKAREA=number 

specifies the number of bytes to be allocated to the common 
work area portion of the CSA. This area is for use by the 
installation, is initially set to binary zeros, and is 
available to all programs. It is not used by CICS/VS. The 
maximum size for the work area is 3584 bytes. The default is 
512 bytes. 


XLT=NOIxx # 

specifies a transaction list table. The table contains a list 
of transactions that can be attached during the first quiesce 
stage of system termination. The default is XLT=NO. See Note 2 
at the beginning of the description of this macro. 


ZCP=g£|xx 

specifies the suffix of the ZCP and ZCX modules that are to be 
loaded by SIP. The default is a suffix of two blanks. Because 
ZCP and ZCX are always required (even for non—VTAM support) , 
specifying a suffix of NO will not suppress loading. NO will 
be treated as a regular suffix value. ZCA and ZCY are loaded 
without suffixes. 

m 

indicates that no suffix is to be added, 
xx 

indicates the one— or two—character suffix to be added. 


For DOS/VS only 


ICVSWT=deciraal—value 

indicates the period of time after which CICS/DOS/VS regains 
control from DOS/VS to check for completion of a disk I/O 
request made by a transaction. 

A disk I/O normally takes between 20 and 40 milliseconds to 
complete. If a very low "short wait" interval is set, 
unproductive processing may be caused; a high value may cause 
an unnecessary increase in response time. The range is 0 
through 1000 milliseconds, with a default value of 40 
milliseconds. The actual value chosen is dependent on the 
requirements of the individual system. 
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Note : CICS/DOS/VS will only take as long as the period 
specified in the short wait interval to detect the completion 
of a disk I/O if there is no other activity in the CICS/VS 
system. Therefore, in a high activity system, the short wait 
value should be set to a low value if it is to have any 
noticeable effect. If ICVSWT=0 is specified, the DOS/VS WAIT 
macro will not be issued whenever disk I/O is in progress. A 
value of 0 should only be used after careful consideration of 
the effect it may have on batch partitions. 


NSD=9|number 

specifies the maximum number of nonsequential disk extents that 
will exist for any data set involved in the execution of 
CICS/DOS/VS. CICS/VS system initialization uses this value to 
determine the amount of storage to be reserved at the beginning 
of the partition for label processing when the data sets are 
opened. Although most data sets are opened during system 
initialization, the dynamic open/close feature of the CICS/VS 
master terminal program may need to use this J.abel processing 
area during the execution of CICS/VS. The presence of this 
operand makes it unnecessary for the user to supply a DOS/VS 
LBLTYP job control statement with the CIVCS/VS execution deck. 
The minimum value that may be specified is NSD=1. 

If the NSD operand is specified in both DFHSG PROGRAM=CSO and 
DFHSIT, the number of disk extents specified will be added. 


For 0S/VS only 


BUFPL=number 

applicable only if the CICS/OS/VS—DL/I interface is to be used 
with pre-IMS/VS Version 1.1.4 ISAM and OSAM data bases, this 
operand is used to specify the DL/I data base buffer pool size 
in 1024—byte blocks. The number of 1024—byte blocks specified 
must be in the range 0 to 999. This operand corresponds to the 
DBASE operand of the IMS/VS BUFPOOLS system definition macro 
instruction and to the HHH parameter of the IMS/VS CTL or CTX 
parameter list for online execution. The default is BUFPL=8. 

This operand has no effect when IMS/VS Version 1.1.4 is used 
with CICS/VS Version 1, Release 4. IMS/VS uses the value in 
the IOBF parameter on the DFSVSAMP options card for ISAM and 
OSAM, and the values on the DFSVSAMP subpool definition 
statement for VSAM. 


DDIR=suffix 

specifies a suffix for the DDIR list and is applicable only if 
the CICS/OS/VS—DL/I interface is to be used. The default is a 
blank suffix. 


DLTHRED=number 

specifies the number of strings (1 to 15) provided through the 
DL/I interface, and is applicable only if the CICS/OS/VS—DL/I 
interface is to be used. The default is 1. The value 
specified in this operand must be large enough to accommodate 
the online DL/I usage plus the shared data base requirements; 
that is, a number of threads equivalent to the number specified 
in the SESNUMB operand in the DFHTCT TYPE=IRCBCH macro. 
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DMBPL=number 

applicable only if the CICS/OS/VS—Dl/I interface is to be used, 
this operand specifies the data management block (DMB) pool 
size in 1024—byte blocks for CICS/OS/VS—DL/I interface support. 
The number of 1024—byte blocks specified must be in the range 0 
to 999. This operand corresponds to the DMB operand of the 
IMS/VS BUFPOOLS system definition macro instruction and to the 
JJJ parameter of the IMS/VS CTL or CTX parameter list for 
online execution. The default is DMBPL=4. 


ENQPL=n 

indicates the maximum size (in K bytes) to be allocated by 
IMS/VS for ENQ control block space. ENQ control blocks are 
heavily used when program isolation scheduling (PISCHD=YES) is 
to be used for DL/I transactions. This parameter is identical 
to the second sub-parameter of the CORE operand of the IMSCTF 
macro, and is provided in CICS/VS because the IMSCTF macro is 
not available for IMS/VS DB users. The default value is 
ENQPL=2. 

For further information on how to calculate the ENQPL value, 
refer to the IMS/VS System Programmer^ Reference Manual . 


IOCP=number 

specifies the percentage of DASD I/O events that the task 
control program will wait on. The value of IOCP may be from 0 
to 50%. (0% is a wait count of one and 50% is a wait count 

equal to half the number of outstanding DASD I/O events.) The 
default is IOCP=0. 


IRCS TRT=NO|YES 

indicates whether the inter—region environment that will be 
used in a shared data base session between CICS/OS/VS and the 
DL/I batch region will be started-up at system initialization. 
The default is NO. If IRCSTRT=YES is not specified, the inter- 
region environment can be initialized by issuing a CSMT 
(IRC , BEG IN) command . 


Chapter 3.2 


DFHSIT 


217 



Page of SC33-0069-2, revised August 1978 by TNL SN33-6217 


Note that initializing the inter—region environment involves 
the allocation of the (potentially large) control blocks 
discussed in the DL/I shared data base section of the OSCOR 
operand (below) . If storage availability is crucial, the CSMT 
(IRC ,BEGIN | END) command should be used to minimize the time 
during which storage is allocated. 


OSCOR=decimal—value 

specifies a one— to six—digit decimal value in the range 0 to 
16770215 (or 2 24 —1) bytes, which indicates the number of bytes 
of storage to be provided from the CICS/OS/VS partition/region 
for the use of the operating system during CICS/OS/VS 
execution. The minimum amount of storage available to the 
operating system is equal to the size of the system 
initialization program (DFHSIP) . The default is OSCOR=8192. 

If the value specified is greater than the size of DFHSIP, the 
amount of storage provided for the use of the operating system 
is equal to the size of DFHSIP plus the amount specified in 
excess of the size of DFHSIP. Note that this storage is not 
available to the operating system until DFHSIP transfers 
control to the dummy CSA program (DFHDCSA) . 

The user should be aware that an incorrect OSCOR specification 
could adversely affect system performance. The value specified 
should accurately reflect the amount of address space required 
by the operating system, depending upon the CICS/VS 
configuration. If, for example, ACF/VTAM (VTAM3) is used, a 
higher OSCOR value will be required. 

The DL/I shared data base facility requires the following 
amounts of storage which must be included in the OSCOR value 
specified: 

• For non—MVS systems, the value specified in the IRBUFSZ 
operand of DFHTCT TYPE=INITIAL must be multiplied by the 
number in the SESNUMB operand in DFHTCT TYPE=IRCBCH • For 
MVS, the shared data base requirements (as stated above) 
need not be in OSCOR, but the (MVS) CSA must be large 
enough to provide the required storage. 

• Approximately IRB + 12K bytes are required in the non-MVS 
batch region (where IRB is the value in the IRB parameter 
in the batch region) . Refer to the CICS/VS System 
Programmer*s Guide (OS/VS) for a discussion on the batch 
JCL for shared data base. For MVS, approximately 12K bytes 
are required in the batch region and IRB + 72 bytes are 
required in the (MVS) CSA. 


OSCOR is free address space within the CICS/VS region/partition 
which may be acquired by the host operating system (OS/VS1 or 
OS/VS2) GETMAIN requests. CICS/VS itself, once initialized and 
running, does not issue host operating system GETMAINs, but 
directs all address space requests to the CICS/VS storage 
control program which satisfies those requests from a 
preallocated address space known as the CICS/VS dynamic storage 
pool. However, the host operating system or services of the 
host operating system used by CICS/VS may cause host operating 
system GETMAIN requests on behalf of CICS/VS. Some of the 
reasons for these storage requests are: 
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BDAM dynamically acquires IOBs and read-exclusive lists. 

The file control program, the transient data program, and 
the keypoint program all use BDAM. 

BDAM will acquire IOBs for each I/O request; therefore 
there will be as many IOBs and segments on the read- 
exclusive list as there are concurrent I/O requests. The 
number of concurrent BDAM I/O events would normally not 
exceed *max Tasks*• 

ISAM dynamically acquires IOBs for I/O requests. The file 
control program may use ISAM. 

ISAM will acquire IOBs for each I/O request, READ, READ 
UPDATE, or WRITE KN. However, READ UPDATE IOBs are saved 
and used for WRITE UPDATE requests before being released. 

VTAM will acquire storage from the CICS/VS partition in 
order to satisfy connection requests such as OPNDST, CLSDST 
and SIMLOGON. Requests are issued as a result of, for 
example, CONNECT=AUTO being specified in DFHTCT 
TYPE=TERMINAL, terminal logon, and the use of the master 
terminal ACQUIRE command. 

Use of dynamic OPEN/CLOSE in CICS/VS will significantly 
increase the amount of OSCOR used. OPEN requests may cause 
acquisition of the following areas: 


• IOBs 

• Channel programs 

• Buffers (extrapartition transient data) 

• Work areas (ISAM) 

• Additional control blocks as determined by the access 
methods used and the host operating system 

• Depending on the host operating system, access methods 
may also be loaded in OSCOR 

CLOSE requests may cause address space of the types 
acquired by OPEN requests to be released and made available 
as OSCOR. 

In addition to the size requirements of OSCOR, additional 
area should be allocated to allow for fragmentation which 
will result from intermixed host operating system GETMAIN 
and FREEMAIN requests of varying size. At least an 
additional 20 to 30 percent should be allowed in OSCOR 
estimates for fragmentation. 

For information concerning host operating system control 
block address space requirements, refer to the specific 
operating system reference manuals, such as the OS/VS1 
Storage Estimates manual. 


PDIR—suffix 

specifies a suffix for the PDIR list and is only applicable if 
the CICS/OS/VS—DL/I interface is to be used. The default is a 
blank suffix. 
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PISCHD=N0|YES 

indicates whether program isolation scheduling (PISCHD^YES) or 
segment intent scheduling (PISCHD=NO) is to be performed for 
transactions that access DL/I data bases. The PCT entry for 
transactions that use program isolation scheduling should 
include DTB=YES and, optionally, RESTART=YES so that a 
transaction that fails can be backed out dynamically and 
restarted automatically after such conditions as a transaction 
deadlock. The default is PISCHD=NO. Further details on 


program isolation scheduling can be found in the 

Cxro+r 4 4 4 /y« Hu 4 


PLISHRE=NO|YES 

specifies whether PL/I shared library support is to be 
included. The default is NO. 


PSB=name 

applicable only if the CICS/OS/VS-DL/I interface is to be used, 
this operand is used to specify the one— to eight—character 
name of the program specification block (PSB) used during 
IMS/VS initialization. This PSB contains a program 
communication block (PCB) for each DL/I access method to be 
used (two PCBs in the case of HISAM) , and is used to load all 
required DL/I modules during initialization. The default is 
PSB=CICSPSB• 

The PSB operand is not applicable, and may be omitted, in the 
case where there are no data bases that are resident on the 
CICS/OS/VS system. This situation arises when all DL/I 
requests from the CICS/OS/VS system are for data bases that 
reside on remote CICS/OS/VS systems (and are accessed through 
the intersystem communication facility) . 


P SBPL=numbe r 

applicable only if the CICS/OS/VS—DL/I interface is to be used, 
this operand specifies the program specification block (PSB) 
pool size in 1024—byte blocks for CICS/VS—DL/I interface 
support. The number of 1024—byte blocks specified must be in 
the range 1 to 999. This operand corresponds to the PSB 
operand of the IMS/VS RUFPOOLS system generation macro 
instruction and to the III parameter of the IMS/VS CTL or CTX 
| parameter list for online execution. The default is PSBPL=4. 
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ACCMET H=NONVTAM | VTAM 

controls the building of the access—method-dependent portions 
of the TCT. If both NONVTAM and VTAM are specified, the TCT is 
£uilt for all access methods. The default is NONVTAM. 

NONVTAM 

Virtual Telecommunications Access Method portion is not 
generated. 

VTAM 

Virtual Telecommunications Access Method portion is 
generated. 


| APPLID=DBDCCICS | name 

specifies a one— to eight—character application name defined to 
VTAM during VTAM system definition. This identifies CICS/VS to 
VTAM as an application program and may be overridden at CICS/VS 
system initialization by the DFHSIT APPLID=name parameter. 

APPLID=name may also be used in this macro to provide the name 
for a CICS/VS system that is communicating with another CICS/VS 
system or with the batch region during a DL/I shared data base 
session under ClCS/OS/VS. APPLID=name will default to DBDCCICS 
if omitted. 


GMTEXT =welcome—to—CICS/VS | ■ text # 

indicates whether the default "good morning" sign-on message 
("welcome to CICS/VS") or a user—supplied sign—on message is to 
appear for each terminal entry when the terminal is sighed on 
to VTAM. The appropriate sign-on message may be specified for 
indididual terminal entries through the GMMSG operand in DFHTCT 
TYPE=TERMINAL• 


OPNDLIM=number 

indicates the open destination/close destination request limit. 
This limit is used to restrict the number of concurrent OPNDSTs 
or CLSDSTs to prevent VTAM from running out of space in the 
CICS/VS region. The default value is 10. When large values 
are used for OPNDLIM, the value of OSCOR in DFHSIT (0S/VS only) 
may need to be adjusted. 


RAMAX=va1ue 

indicates the size in bytes of the I/O area allocated for each 
RECEIVE ANY issued by CICS/VS. The maximum value is 65515. ■* 


RAMI lvalue 

indicates the data length size below which RECEIVE ANY input is 
transferred from the RECEIVE ANY I/O area to a new TIOA. The 
length of the new TIOA is the greater of the data length or 
TIOAL. The maximum value is the value of RAMAX. If this 
operand is not specified the default is zero. 


RAPOOL=value 

specifies the number of fixed RPLs that are generated in the 
TCT prefix. When not at MAXTASK, CICS/VS maintains a RECEIVE 
ANY for each of these RPLs. The number of RPLs required is 
dependent on the expected activity of the system, the average 
transaction lifetime, and the MAXTASK specified. The default 
value is 2. 
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RATIMES=value 

specifies the multiplier used to establish the maximum 
allowable initial input message length. If the data exceeds 
the RAMAX I/O area, a new area up to a maximum size of, RAMAX x 
RATIMES is allocated. If the data exceeds this length, a 
negative response is returned to the logical unit. This 
operand is optional and defaults to a value of 2. 

Note : This operand is not used with VTAM-supported 3270s, 
because the maximum allowable input from a 3270 equals a buffer 
size, whatever the value of RATIMES. 


RESP=response—type 

specifies the type of response CICS/VS is to request when 
transmitting data to a logical unit. FME is the default and is 
the normal type of response. 

FME 

indicates that a function management end (FME) response is 
to be requested. This is equivalent to specifying a 
definite response type 1 (DR1) . 

Note : This option is not used with VTAM—supported 3270s, 

because FME is always requested. 

RRN 

indicates that a reached recovery node (RRN) response is to 
be requested. This is equivalent to specifying a definite 
| response type 2 (DR2) . RESP=RRN may only be specified for 

| 3600 systems. 


SUFFIX=xx 

specifies a one— or two—character alphameric suffix for the 
terminal control table being assembled. This suffix, if 
specified, is appended to the standard module name (DFHTCT) and 
is used to name the module on the linkage editor output 
library. If this operand is omitted, a suffix is not provided. 


For DOS/VS only 


MODNAME=name| IJLBTM 

specifies the BTAM modules to be requested by name. The 
default is MODNAME=IJLBTM• 


name 

specifies the BTAM module name. 

IJLBTM 

indicates the system default name if MODNAME=name is not 
specified. 

Note : BTAM modules and names must be assembled and cataloged 

as described in the CICS/VS System Programmer*s Guide (DOS/VS) . 
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For oS/VS only 


IRBU FSZ=1ength 

indicates the maximum length of data sent to CICS/VS for a 
batch request during a DL/I shared data base session under 
CICS/OS/VS. The value for IRBUFSZ should be calculated using 
the following information: 

• The inter—region buffer contains a single DL/I request. 

For an input request the buffer contains: 

— control information (approximately 40 bytes) 

— the SSAs specified on the request. (Each SSA occupies 
"SSA" bytes , where "SSA" is the value of the SSA 
parameter on the sharing batch PARM Field.) 

• For an output request , the buffer contains the same as for 
the input/ plus: 

— The DL/I I/O area; the I/O area is assumed to occupy 
the maximum size that an I/O area can occupy for the 
scheduled PSB. Thus/ sharing batch programs should not 
use PSBs that allow "path" access unless they are 
actually using that type of access. 

• For a LOG request/ the buffer contains a 40-byte header and 
the application program*s log record. 

The IRBUFSZ value should be large enough to contain the largest 
buffer needed. The maximum value for IRBUFSZ is 65500 bytes. 


LINE GROUP TYPES — DFHTCT TYPE=GPENTRY 


Available for CICS/DOS/VS only/ the DFHTCT TYPE=GPENTRY macro 
instruction may be used with the following device types in a non—VTAM 
environment: 

• Local 3270 

• Remote 3270 

• Multipoint 2740 

• Point—to—point 2740/2741 

• Dial-up 2740/2741 

• Processing unit console operating as a terminal 

• Sequential devices used to simulate terminals 

The DFHTCT TYPE=GPENTRY macro allows the system programmer to specify 
terminal types and device characteristics on a line group basis , and may 
be used instead of indicating the desired features in the DFHTCT 
TYPE=SDSCI/ LINE, and TERMINAL macro instructions. 

The options in each operand of this macro are positional; for 
example/ LINFEAT= (O/B//B) indicates that the first terminal in this line 
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group has open polling, the second terminal has the buffered receive 
feature, and the fourth also has the buffered receive feature. 



TYPE=GPENTRY 

,GPTYPE=type 

[ ,ALTSCRN= (lines,columns) (,...) J 
[ ,CUADDR= (nn[ ,..],..) ] 

[,CUFEAT= (feature[,...],...) ] 

[ ,CUPOSN= (nn[ ,...],...) ] 

[ ,GPBLKSZ= (nnnnn[ ] 

[ , GPNAME= (INname, OUTname) (,....,_) ] 

t ,GPNTRMS= (nn[ ,..],..) ] 

[ ,GPSEQLU= (nnn[ 

[,GPTCU={2701|2702|2703|ICA} ] 

[ ,LINELST= (nnn[ ,...],...) ] 

[ ,LINFEAT= (feature[ ] 

[ ,LININL= (number[ ,...]»*••) 3 
[ ,TRMADDR= (nn[ ] 

[ ,TRMFEAT= (A,D,S,U,P,T) ] 

[ ,TRMIDNT= (xxxx[ ] 

[ ,TRMINL= (number[ ] 

[ ,TRMMODL= (number,character) , (...,...) ] 
[ ,TRMPOSN= (nn[ ,..],..) ] 

C ,TRMPRTY= (number[ ] 

[ ,TRMSTAT=(T,I,A,X,R) ] 

[ ,TRMUAL= (numbert ] 


TYPE=GPENTRY 

indicates that a terminal line group entry is to be made. 


GPTYPE=type 

specifies the type of terminal in the line group. One type 
option may be specified in each DFHTCT TYPE=GPENTRY macro. The 
options are: 

• 3270L - Local 3270 

• 3270R — Remote 3270. The suffixes A (ASCII support) or E 
(EBCDIC support) may be appended. 

• 274QS — Multipoint 2740 with the station control feature. 
The following suffixes may be appended: 


C — for the VRC/LRC checking feature 

A — for the start/stop autopoll feature. This option cannot 
be used for lines attached to a 2701. 

CA — for both these features. 

• 2740 — Point—to—point 2740/2741. The options are: 
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2740 — 2740 model 1 without the VRC/LRC checking feature 
2740C — 2740 model 1 with the VRC/LRC checking feature 
2741C — 2741 with correspondence code 
2741E — 2741 with PTTC/EBCD transmission code 
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The DSCNAME for BTAM data sets must be the same name as that 
specified in the DSCNAME =name operand of the DFHTCT TYPE=LINE 
macro instruction. This operand is not required for console 
terminal support under CICS/DOS/VS. 


BLRSIZE=length 

| specifies, for sequential data sets, TCAM queues, and 7770 

Model 3s, the maximum length (in bytes) of a block. 

For CICS/OS/VS, the default is BLKSIZE=0. If this operand is 
omitted, the block size can be specified in the data definition 
pD) statement associated with the data set. A more detailed 
explanation of this operand is given in OS/VS Data Management 
Macro Instructions . 

For CICS/DOS/VS, the default is BLKSIZE=80. A more detailed 
explanation of this operand is given in DOS/VS Supervisor and 
I/O Macros . 

For 7770 Model 3s this value should be the same as that 
specified for INAREAL in the line entries that reference the 
DSCNAME of this DFHTCT TYPE=SDSCI macro instruction. 

| For TCAM queues, the block size value must specify the maximum 

I length that any CICS/VS application program will require to be 

| written in one request. Note that CICS/VS application programs 

| include the master terminal command. A block size of at least 

| 2024 bytes (one screen size plus attribute bytes) should be 

| specified. 


BS 00 DE =EBCDIC IASCII 

specifies the type of binary synchronous transmission code. 
The default is BSCODE=EBCDIC. 

EBCDIC 

indicates transmission in Extended Binary Coded Decimal 
Interchange Code. 

ASCII 

indicates transmission in American Standard Code for 
Information Interchange. 


ERROPT=option 

specifies the error recovery, error recording, and online test 
options to be provided for the line group. The applicable 
keyword parameters are: 

E 

specifies that the basic error recovery procedures are to 
be provided for the line group. If ERROPT is omitted, 
ERROPT=E is assumed. 

R 

specifies that text-read errors are to be retried in 
addition to the basic error recovery procedures. This 
option is only valid for the following terminals: 1050 
terminals (valid for the card reader and paper tape reader 
only if the line correction feature is installed) , 274 0 
terminals with the checking feature, and 2260 terminals. 

W 
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specifies that text—write errors are to be retried in 
addition to the basic error recovery procedures. This 
option is valid for start/stop terminals. It results in an 
additional copy of the message for each retry (except for 
the 2260 with line address feature, and the 1050 card punch 
and paper tape punch with the line correction feature) . 

This parameter is ignored for binary synchronous terminals. 

C 

specifies that threshold error counts and cumulative error 
counts are to be maintained in the line error recording 
block (LERB) for the line for data check, intervention 
required, and non-text timeout errors. This parameter is 
applicable only to CICS/OS/VS. For CICS/DOS/VS, the LERB 
support is generated if the LERBADR parameter is specified. 

N 

specifies that no error recovery procedures are to be 
provided for the line group. This parameter and E,R,W, and 
C are mutually exclusive. This parameter is invalid for 
binary synchronous stations? if coded, it is ignored. For 
Teletypewriters (WTC only) r N is the default. 

RW 

specifies that error recovery is to be performed with “read 
text retry* and “write text retry.* 

T 

specifies that the online test facility is to be used for 
the line group. Applicable only to CICS/OS/VS, this 
parameter is valid for all IBM terminals with or without 
error recovery capability. 

Notes : 

1. For CICS/OS/VS, EROPT is also a valid spelling of this 
operand. 

2. Commas must not be coded in this operand. For example, 
ERROPT=RECWT. 

3. ERROPT= is not valid for TCAM devices because error 
recovery is performed in the message handler. 


LERBADR=symbolic—address 

specifies the label of the BTAM line error recording block 
(LERB) which the user creates by means of the BTAM •LERB* macro 
instruction. LERB is also a valid spelling. 

Notes : 

1. For CICS/OS/VS , this parameter should not be specified 
unless ERROPT=C is also specified. 

2. This parameter should not be specified for local terminals 

(2260L or 3270L) . 
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For ClCS/DOS/VS only 


CONF1G=PPT|MPT 

specifies the type of binary synchronous line configuration. 
The default is CONFIG=PPT. 

PPT 

indicates that the data link between the processor and the 
remote binary synchronous device is point-to-point. 
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6 

specifies component polling of reader 1 for the 1050 
Data Communication System using non—switched 
communication lines. Component selection character 6 

(OD) must be coded in the polling list (DFTRMLST) . 

7 

specifies the component polling of reader 2 for the 
1050 Data Communication System using nonswitched 
communication lines. Component selection character 7 

(OE) must be coded in the polling list (DFTRMLST) . 

11 

specifies the 3275 Display Station Model 11. The 
CICS/VS support obtained will be identical to that for 
specifying TRMMODIr=l for 3275 Display Station Model 1. 

12 

specifies the 3275 Display Station Model 12. The 
CICS/VS support obtained will be identical to that for 
specifying TRMM0DL=2 for 3275 Display Station Model 2. 

0 

specifies an input component for the 1050 Data 
Communication System. Common polling character 0 (15) 
must be coded in the polling list (DFTRMLST) . 

TRMMODL^O is the default specification for a 1050 Data 
Communication System. 

character 

specifies the applicable screen format for a 2260/2265 
display station as follows: 


Specification 

Screen 

Format 

TRMMODL=A 

6X40 

2260 

TRMMODL=B 

12X40 

2260 

TRMM0DL=C 

12X80 

2260 

TRMMODL=D 

15X64 

2265 

TRMMODL=E 

12X80 

2265 


For example, TRMMODL=A specifies a 2260 Display Station 
with a 6X40 screen format. 


TRMPRTY=number 

establishes the terminal priority. This decimal value (0 
through 255) is used in establishing the overall transaction 
processing priority. (Transaction processing priority is equal 
to the sum of the terminal priority, transaction priority, and 
operator priority, not to exceed 255.) The default is 
TRMPRTY=0. 


TRMSTAT=terminal—status 

specifies the type of activity which may occur at a given 
terminal. This terminal status is initially set in the TCTTE 
and is a combination of the processing status and the service 
status. 

TRANSACTION 

indicates that a terminal with TRANSACTION status is used 
in the processing of transactions such as inquiries or 
order entries. A display station or a hard-copy terminal 
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to which no messages are sent without a terminal request 
and through which transactions are entered is a TRANSACTION 
terminal. If no other status designation is made, the 
terminal status defaults to TRANSACTION. 

Note: This is the only processing status allowed for 3790 
inquiry logical units. 

TRANSCEIVE 

indicates that a terminal with TRANSCEIVE status is a 
TRANSACTION terminal to which messages are sent 
automatically by the user. The automatic transaction 
initiation, either by transient data control or interval 
control, sets a condition in an appropriate terminal 
control table terminal entry. If the terminal status is 
TRANSCEIVE and if there is no transaction at the terminal, 
terminal control initiates the user—defined task. This 
task is expected to send messages to the terminal. 

Note : If automatic transaction initiation is used, the 

minimum TIOAL that can be specified is one byte. 

RECEIVE 

indicates a terminal to which messages are sent but from 
which no input is allowed. An example of this type of 
terminal is one which is located in a remote location, such 
as a warehouse, and is unattended, but may receive 
messages. Automatic transaction initiation is implemented 
as for TRANSCEIVE above. 

Note : RECEIVE should be specified for a System/7 with the 

Station Control feature. This allows polling to be 
suspended until the System/7 receives an IPL from the host, 
at which time the status is changed to TRANSCEIVE. If the 
System/7 receives a remote IPL, the master terminal must be 
used to change the terminal status to enable the System/7 
to transmit. 


IPL 

specifies that this is the logical terminal entry required 
for the IPL address of the System/7 with BSCA. To IPL a 
System/7 on a Bisync line, a TCTTE must be generated 
exclusively for the IPL operation. This operand causes the 
logical terminal to be generated in RECEIVE status and sets 
the terminal model number to *9* to signify an IPL 
terminal. The status of an IPL terminal may not be changed 
except to in-service or out—of—service. 


INPUT 

indicates a terminal which can send messages to, but cannot 

receive messages from, CICS/VS. 

Notes : 

a. INPUT status is not valid for the 3270 and the 3790 
| inquiry logical unit. If TRM5TAT=INPUT is specified 

| for these logical units, or if the status of these 

| logical units is changed to INPUT (for example, by a 

| CSMT command) , the terminal control program will regard 

| the logical unit as being in TRANSACTION status, 

| although the master terminal will display it as still 

| being in INPUT status. 
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b. System messages may be routed to an input terminal 
under conditions such as invalid transaction 
identification and ATP batch count. This causes 
DFHTACP to be scheduled. To handle this situation, the 
user should code a DFHTEP to perform any user required 
action. See "User-Written Terminal Error Programs" in 
Chapter 4.2 of this manual. 
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Chapter 3.4. Table Preparation for DL/I Facilities 


This chapter provides details on how to include DL/I facilities in a 
CICS/DOS/VS or a CICS/OS/VS system. 


DL/I WITH CICS/DOS/VS 


The specification of system table macros for DL/I support in CICS/DOS/VS 
requires the following steps: 

• .Generation of the IMS/VS Data Base system as described in the DL/I 

DOS/VS Utilities and Guide for the System Programmer manual. 

• Generation of the CICS/DOS/VS system as described in Part 2 of this 
manual• 

• The DL/I DOS/VS application control table (ACT) must be generated — 
(refer to the DL/I DOS/VS Utilities and Guide for the System 

Programmer manual.) 

• An entry must be included in the file control table (FCT) for each 
DBD corresponding to a physical data base. The name of the DATASET 
parameters in the FCT and the DBD must be identical. 


DL/I WITH CICS/OS/VS 


The specification of DL/I support in CICS/OS/VS requires the following 
steps: 

1. Generate the IMS/VS Data Base system (see the IMS/VS Version 1 
System Programming Reference Manual) , including the program 
specification blocks (PSBs) and the data base descriptors (DBDs) . 

2. Generate the CICS/OS/VS system as described in Chapter 2.2 of this 
manual. 

3. Generate the required IMS/VS control blocks to define the DL/I 
system to CICS/OS/VS. 

Ensure that an entry is included in the file control table 
(FCT) for each DBD corresponding to a physical data base. The 
name of the DATASET parameter in the FCT must be the same as 
that in the NAME parameter in the DBD. Entries are also 
required in the file control table for data bases that are to 
be accessed from sharing batch regions through CICS/OS/VS. 
Physical, logical, and index data sets must be represented in 
DFHFCT and in DFHDLDBD if the CICS/VS master terminal 
facilities are to be used to close data bases. 

Define the following special requirements needed to generate 
DL/I program specification blocks (PSBs) when using DL/I under 
CICS/OS/VS. 
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(1) A special initialization PSB is used by CICS/VS-DL/I 
initialization to bring the proper DL/I modules into 
storage. This PSB, called the “initialization PSB*, is not 
used by any transaction. Program communication blocks 
(PCBs) are defined within the PSB to indicate what type of 
CALLS and data bases DL/I will be called upon to service. 
The following rules apply: 


— Define one data base PCB (TYPE=DB) for each of the 
following access methods to be used: HSAM, HDAM. 

— Define one data base PCB for each of the following 
access methods to be used with VSAM: HISAM, HIDAM, 

HDAM, SHISAM. 

— Define two data base PCBs for the same data base for 
each of the following access methods to be used with 
ISAM: HISAM, HIDAM. These PCBs will be referred to as 
a PCB pair. Their specification causes BISAM rather 
than QISAM to be used. 

— Within each PCB, define PROCOPT (processing options) to 
include all processing options to be performed against 
all the data bases using that access method. That is, 
if one HDAM data base is to be accessed via PROCOPT=GE 
and another via PROCOPT=GRP, the combined PROCOPT to be 
specified is PROCOPT=GRPE. 

— For each PCB being defined, provide one SENSEG 
statement. For the PCB pairs required for HISAM or 
HIDAM with ISAM (see above) , the SENSEG statements must 
refer to the same segment type. If the use of QISAM is 
desired in addition to BSAM, provide an additional 
SENSEG statement in one PCB of the PCB pair 

— In the PCB statement, specify KEYLEN to be the length 
of the key field defined in the SENSEG statement in (e) 
above. 

— The last statement preceding the END statement in the 
assembly should be written: 


PSBGEN LANG=ASSEM , PSBNAME=psbname 

If DL1=YES is specified during CICS/VS system 
initialization, the PSB used is named CICSPSB unless 
overridden in the system initialization table or by the 
execution time PSB parameter• 

If the CICS/OS/VS system is to handle requests for remote 
data bases only, no data-base processing will occur on the 
local system. In this case, no initialization PSB need be 
specified, but the system programmer must ensure that all 
the PSBs specified in the PDIR (see “Generate PDIR 
pFHDLPSB) “, below) are for remote PSBs. A DDIR, without 
any DFHDLDBD TYPE=ENTRY statements, must be generated. 

I In the event of a program isolation deadlock, two types of 

\ transactions will be involved: a mirror transaction, and a 

| transaction of another type. If two transactions of the 

| same type become deadlocked, the system programmer may 

| choose which one to abnormally terminate. If a mirror 
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| transaction and a different type of transaction become 

I deadlocked, the non-mirror transaction must be abnormally 

| terminated. 

When program isolation scheduling is used, there is no need 
for the user to create duplicate PSBs. More than one 
transaction can use the same update PSB. 

If an application program wishes to access a PSB that 
resides on another CICS/OS/VS system, there must be an 
entry for the PSB in the PDIR. The entry must specify the 
SYSIDNT and MXSSASZ (and, optionally, RMTNAME) operands. 

(2) If an application programmer does not name a PSB in the 
DL/I CALL, the PSB used has the name of the program whose 
name is in the program control table (PCT) entry for this 
transaction. Therefore, for all transactions with DL/I 
CALLS where the PSB name is not specified, there must be a 
PSB generated with the same name as the program name in the 
PCT entry for the transaction. For PL/I programs, specify 
that the PSB is for PL/I. 

(3) If an application programmer names a PSB in the DL/I CALL, 
there must be a PSB generated with the name used in that 
CALL. For PL/I programs, specify that the PSB is for PL/I. 

(4) If DL/I shared data base support is required, the following 
system table macros and operands must be specified: 


• IRBUFSZ=value in DFHTCT TYPE=INITIAL 

• DFHTCT TYPE==IRCBCH,SESNUMB=number 

• IRCSTRT=YES in DFHSIT or CSMT IRC,BEGIN from the master 
terminal 

• DFHSIT,ISC=YES or xx, or as an override 

• DFHSIT,EXEC=YES (or default) 

• DFHPCT TYPE=GROUP,FN=ISC 

• DFHPPT TYPE=GROUP,FN=ISC. 


The CICS/OS/VS—DL/I interface uses the pre-built blocks feature of 
DL/I. After all program specification blocks (PSBs) and data base 
descriptions (DBDs) have been generated, the user must then generate 
application control blocks (ACBs) in the IMS/VS ACB Library for all PSBs 
and DMBs to be used (including those that are to be accessed from 
sharing batch regions through CICS/OS/VS) . The instructions for this 
generation are included in the IMS/VS Utilities Reference Manual . 

A PSB directory (PDIR) list and a DMB directory (DDIR) list must be 
built for the CICS/VS—DL/I interface. Each of these lists is built by a 
separate assembly and link edit. 


GENERATE PDIR (DFHDLPSB) 


The PDIR is generated by an assembly of DFHDLPSB macros as follows: 


I 


| DFHDLPSB| TYPE=INITIAL 
| | [,DLI=y.y.y] 

| | [,SUFFIX=xx] 
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TYPE=INITIAL 

establishes the control section into which the PSB directory 
list is assembled. 


| DLI—y.y.y 

indicates the IMS/VS level in the form: Version. Release. 
Modification level. Levels of IMS/VS prior to 1.1.2 are 
treated in one manner, and levels 1.1.2 and later are treated 
differently. 


SUFFIX=xx 

specifies a one— or two—character alphameric suffix (other than 
"NO* — which is reserved) for the PSB directory being 
assembled. This suffix, if specified, is appended to the 
standard module name (DFHPSB) and is used to name the module on 
the linkage editor output library. If the operand is omitted, 
a suffix is not provided. 


|DFHDLPSB| 

TYPE=ENTRY 

i t 

,PSB=psbname 

i i 

[,MXSSASZ=value) 

i i 

[,RMTNAME=name] 

i i 

[,SYSIDNT=name] 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
list. The maximum number of entries that can be included in the 
list is 2000. 


PSB=psbname 

specifies the name of the program specification block (PSB) . 
The PSBs required by IMS/VS batch application programs that 
participate in a shared data base session must be represented 
in this macro. 


MXSSASZ=value 

specifies the maximum size of a segment search argument to be 
used for this PSB. This operand is only required if the 
SYSIDNT operand is specified. 


RMlNAME=name 

indicates the name by which the PSB is known in the remote 
system and need only be specified when the SYSIDNT operand is 
used. The default is the psbname specified in the PSB operand. 
If the original application program that makes the request 
against this PSB is not on this system, or is a batch program 
using shared data base support, the PSB must be local to this 
system. Chaining of requests from one system to another is not 
allowed. 
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SYSIDNT=name 

indicates the name of the remote system for which the PSB is 
applicable in an intersystem commmunication session. The name 
specified must be the same as that in the SYSIDNT operand in 
the TCT. The local system is assumed if this operand is 
omitted. 


i--- 

| |DFHDLPSB| TYPE=FINAL 

i_ __ ___ 


i 


I 

j 


TYPE=FINAL 

| indicates the end of the PSB directory list. An END DFSIDIRO 

| statement must also be specified. 


GENERATE DDIR pFHDLDBD) 


The DDIR is generated by an assembly of the following DFHDLDBD macros: 


|DFHDLDBD| TYPE=INITIAL 
| | [ , DLI=y .y- y ] 

I | [,SUFFIX=xx] 


TYPE=INITIAL 

establishes the control section into which the DMB directory 
list is assembled. 


DLI=y.y.y 

indicates the IMS/VS level in the form: Version. Release. 
Modification level. Levels of IMS/VS prior to 1.1.2 are 
treated in one manner, and levels 1.1.2 and later are treated 
differently. 


SUFFIX=xx 

specifies a one— or two-character alphameric suffix (other than 
"NO" — which is reserved) for the DMB directory being 
assembled. This suffix, if specified, is appended to the 
standard module name (DFHDMB) and is used to name the module in 
the linkage editor output library. If the operand is omitted, 
a suffix is not provided. 


r--- 

| |DFHDLDBD| TYPE=ENTRY 

| | | ,DBD=dbdname 

i_ 


I 

I 

j 


TYPE=ENTRY 

specifies that one or more entries are to be generated in the 
list. The maximum number of entries that can be included in 
the list is 5000. 
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DBD=dbdname 

specifies the name of the data base descriptor block (DBD) . In 
an inter-region communication environment, only those DBDs that 
reside in the given CICS/OS/VS system need appear in the DDIR. 
Thus, if an application program in the local system makes a 
request for a data base on a remote system, the corresponding 
I DBD (s) need not appear in the DDIR for the local system. Any 

| data bases that are to be accessed by sharing regions should be 

| included in the DDIR. 


Note : If there are no local data bases on the CICS/OS/VS system (that 

is, if the DL/I application programs make requests for remote data bases 
only) , a DDIR (with no TYPE=ENTRY statements) must still be generated. 


i- 

| |DFHDLDBD| TYPE=FINAL 


l 


I 


TYPE=FINAL 

| indicates the end of the DMB directory list. An END DFSIDMDO 

| statement must also be specified. 


RESTRICTIONS ON THE IMS/VS BATCH APPLICATION PROGRAMMER 


The IMS/VS batch application programmer must be aware of certain 
restrictions that exist when DL/I batch application programs run in a 
shared data base environment under CICS/OS/VS. These restrictions, 
which do not affect the CICS/VS application programmer, are as follows. 

Three types of DL/I requests may be issued by a batch application 
program: 

• All data base access calls (GUjz^, GN>5)0, GNPJzJ, GHUJzJ, GHNP, GHNJ0, 

ISRT, DLET, and REPL) 

• System service calls — (CHKP and LOG only) 

• ROLLBACK call, which results in the following: 

— Message DFH3731 will be issued 

— Any DL/I updates since the last CHKP call (or since the start 
of the jobstep) will be backed out (assuming that dynamic 
transaction backout is active in the CICS/VS region) 

— The batch region will be abnormally terminated with a user 
abend code of 3731 

Note : If the application program issues a CHKP call and the CICS/VS 

shared data base session is in quiesce (that is, if the master terminal 
has issued CSMT SHUT or CSMT IRC,END) , the application program will 
terminate immediately after the CHKP call with a user abend code of 3707 
or 3708. 

The first byte of a log record used in a LOG call must be equal to or 
greater than X^O*, as in IMS/VS DB. An additional restriction when 
using shared data base is that the second byte of the record must be 
X*00•. If these restrictions are not observed, a PCB status code of GL 
is returned, and the record is not logged. 
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IMS/VS application programs that use GSAM PCBs or PCBs with PROCOPT=L 
or LS (that is, those used for loading a data base) are not supported in 
the batch shared data base environment. 

In all other respects, IMS/VS batch application programs run 
satisfactorily in a shared data base session without being recompiled or 
re—linkedited. IMS/360 application programs, however, are not 
supported. The IMS/VS batch application programmer should be aware, 
however, that resources used by batch programs must be released as soon 
as possible (by means of CHRP calls) so that online programs are not 
delayed by waiting for these resources. 

Application programs that are used in a shared data base session may 
issue SPIE and STAE macros. When a DL/I request is made by the 
application program, the batch region controller modules will issue 
their own SPIE macro for the duration of the request, and will then 
restore the user's SPIE, if any. 

There are certain abnormal terminations from which recovery cannot be 
attempted. Indeed, in these situations, the batch region controller 
will have broken the link between the batch regions and CICS/VS. 
Therefore, the user application program should not use a STAE (or ESTAE) 
exit unless the exit continues the abend. The PL/I STAE option should 
not be used because the PL/I (E) STAE exit continues the abend. 

If the user*s application program completes by returning to the batch 
region controller, the controller will assume that the application 
program has completed successfully and may indicate to CICS/VS that any 
DL/I data base updates should be committed rather than backed out. If 
the application program wishes to indicate that the updates should be 
backed out, it should issue an OS/VS ABEND macro or a DL/I ROLLBACK 
call. If a program check occurs and the user has no SPIE exit, an abend 
will be forced. Note that the PL/I SPIE exit will return to the batch 
region controller without issuing an abend. For this reason, the PL/I 
SPIE option should not be used. 

For information on all JCL changes that must be made to support the 
batch jobstreara in CICS/OS/VS, refer to the CICS/VS System Programmer"s 
Guide (OS/VS) . 
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• 42 bytes for the block length field and the block label record 

• 30 bytes for the record length field and the system prefix 

• Sufficient space to satisfy the largest journal output request made 
through the journal control request, including: 

The length of the user prefix (plus 2 bytes) if specified by the 
PFXLGTH operand in the journal control output request. 

The length of the journal record as specified by the JCDLGTH 
operand in the journal control output request. 

The maximum buffer size is 32767 for tape or the track capacity of 
the device for disk. 

Other factors which need to be considered in selecting buffer size 
include: 

| • If DL/I logging is being done through CICS/VS journaling, the 

| minimum buffer size that can be specified is 1100 bytes. 

• The volume of records to be written. 

• The lengths of the records. 

• The percentage of synchronous requests. (When a synchronous 
request is made, the record is moved to the output area and the 
block is written regardless of its length. Control is not returned 
to the program which issued the journal output request until the 
data is recorded on the journal device.) 

• The advantage of allowing space in the buffer for additional blocks 
to be built while asynchronous blocks are being written. 

The following statistics are gathered for each journal to assist in 
tuning: 

• The number of output requests made. 

• The number of blocks written. 

• The average length of blocks written. 

• The number of times the buffer was full and a block had to be 
written before the next record could be moved to the buffer. 

• The number of occurrences of buffer shift—up. 

Buffer shift—up is a technique used by journal control to maximize 
free space in a journal buffer. This allows a smaller buffer to be used 
without impacting response time. This technique results in shorter 
output blocks while adding a small processing overhead for buffer 
reorganization. Normally, records are added to a variable—1 ength block 
until there is insufficient free space in the buffer for the record or 
until a block is forced out by a synchronous request. However, when 
using the buffer shift—up technique, the writing of a block may begin 
when the block is filled to the buffer shift—up value. 

For purpose of illustration, assume the following specifications and 
events: The buffer size is 1800 bytes, the buffer shift—up value is 
1200 and no synchronous output requests are made. Records are moved to 
the buffer until 1140 bytes are used. The next record for this journal 
occupies 80 bytes, including its prefix. The record is moved to the 
buffer and a write operation is initiated for that block because the 
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buffer shift—up value is reached. The next block is initiated by 
building its block label record beginning in the 1221st byte of the 
buffer. Control is then returned to the requesting program. This 
journal is able to add records to the next block until output event 
completion time for the previous block. At that time, the second record 
in the buffer is shifted—up, that is, it is moved so that it begins in 
the first byte of the buffer. If the buffer is filled before completion 
of the previous write event, the task will have to wait before shifting 
the buffer. 

The buffer shift—up value is specified by the BUFSUV operand of the 
DFHJCT TYPE=ENTRY macro instruction. The maximum value for this 
operand, and the default, is the value specified by the BUFSIZE operand. 
With the maximum specification, shift—up will never occur. If a user 
wants to use the shift—up technique, it is suggested that he initially 
specify a shift—up value in the range of 50 to 75 percent of the buffer 
size. The statistics described above should be considered for tuning 
aids. There is no minimum for the buffer shift—up value, but it is 
unlikely that the user would specify a value less than 50 percent of the 
buffer size unless his intent is to have a large buffer to prevent 
paging and yet write short journal blocks. However, there is no 
guarantee that all blocks will be short. 

If asynchronous writes are being made to a journal file, and if one 
block is being written because the block size value has reached the 
value in BUFSUV, the next block will have records added to it until the 
last SIO has completed. This could result in the next block containing 
more records than are implied by the BUFSUV operand. 

Each journal task acquires space for a TCA, a JCA, and the specified 
buffer size at the time it is created during system initialization. The 
TCA has a TWA length of zero. The JCA is 128 bytes in length. The user 
should do the following to minimize the paging of these areas: 

• Specify CLASS=LONG for the journal task*s entry, transaction CSJC, 
in the program control table. 

• Calculate BUFSIZE such that the total area acquired for the task, 
TCA plus JCA plus BUFSIZE, equals, or is a multiple of, the VS page 
size for the user*s system. 


ADDITIONAL JOURNAL OPTIONS 


The following options may be specified through the JOUROPT operand of 
the DFHJCT TYPE=ENTRY macro instruction. 

RETRY specifies that if an I/O error is detected on output, journal 
control is to close the current volume (tape reel or disk extent) , 
switch volumes, and try to write the block on the alternate volume. If 
the retry also fails (or if RETRY is not specified) a permanent I/O 
error condition exists. 

CRUCIAL specifies that this journal is vital to the user’s system and 
CICS/VS will abend when a permanent I/O error is detected. If CRUCIAL 
is not specified, the journal is closed and the journal task is 
terminated. The CRUCIAL option is always in effect at the time the 
journal is opened or volumes are switched. 
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Chapter 4.7. Warm Restart 


CICS/VS warm restart restores the status of the following information to 
their status at a previous warm shutdown of the CICS/VS system: 

• Intrapartition transient data 

• Processing program table (PPT) 

• Program control table (PCT) 

• Terminal control table for non-switched terminals and lines 

• File control table 

• Interval control elements 

• Automatic initiate descriptors 

• Batch control areas for asynchronous transaction processing (ATP) 

• Write request elements for ATP 

• Auxiliary temporary storage tables and the bit use map 

• Common system area parameters saved by the warm keypoint 

In some situations a full warm restart may not be necessary. The 
alternatives are a partial warm restart (where tables are individually 
warm or cold started) , or a cold start. The system programmer*s only 
involvement in this facility is to define in the system initialization 
table which resources are to be restarted. 

The warm restart facility is only available after a previous 
controlled shutdown of CICS/VS (that is, when CSMT SHUT,NO has been 
issued) . The facility may also be used after an abnormal shutdown. The 
ABKPOPT option in DFHSIT determines whether a warm keypoint should be 
taken during abnormal shutdown. Note, however, that if the system has 
protected resources, warm restart will not perform backout of any 
uncompleted changes made to these resources before the shutdown. Rather 
than perform a warm restart, an emergency restart should be made. 

| The processing program table (PPT) may be HOT started if PPT=HOT is 
| specified in DFHSIT. The difference between warm and hot starts for the 
| PPT is that on a HOT start the track/address (TTR) fields in the PPT are 
| recovered and there is no need to go through the BLDL routine. The HOT 
| start facility can only be used if no modules are recataloged during the 
j period that CICS/VS is down. 
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Chapter 5.3. The CICS/OS/VS TCAM Interface 


This chapter describes the use of TCAM under CICS/OS/VS. The following 
topics are discussed: 

• The use of TCAM in an SNA network, with reference to protocol 
management, FMH processing, and error processing. 

• The TCAM application program interface, including information on 
the process control block and the TPROCESS control block. 

• The interface between TCAM and CICS/OS/VS, which includes 
information on terminal entries (TCTTEs) and line entries (TCTLEs) 
data flow, logic flow, the terminal error program, message routing, 
pooling, and segment processing. 

• Device considerations, which deals with message formats for devices 

(in particular, the 2260 and 3270) being used on a TCAM line. 

• User exits, which gives information on the three TCAM exits which 
may be specified in the terminal control program. 

• The process of starting up, restarting after an abend, and 
terminating TCAM under CICS/OS/VS. 

• The TCAM message control program and its relationship to the 
application program (in this case, CICS/OS/VS) . 

In addition, two sample TCAM message control programs for use in an 
SNA network can be found in Appendix F. 

The majority of independent teleprocessing applications require a 
dedicated network. The telecommunications access method (TCAM) permits 
multiple applications to share a single network, resulting in more 
efficient use of terminals and lines. The CICS/OS/VS/TCAM interface 
enables CICS/OS/VS to run as an application program under TCAM. 

TCAM is an access method that may be used alone or in combination 
with other access methods (BTAM, BSAM, VTAM, and BGAM) . 

One practical use of the CICS/OS/VS/TCAM Interface is to run a 
■production" CICS/OS/VS system in one region and a "test* CICS/OS/VS 
system in another. Running in separate regions, the applications are 
protected from one another. Operating under TCAM, terminals and lines 
can be shared by the two CICS/OS/VS applications. Other TCAM 
applications such as the time sharing option fTSO) can also be running 
concurrently. 

CICS/OS/VS user tasks that run under BTAM can, in general, run under 
TCAM without modification to the task code. This assumes that the user 
Has properly designed and coded the TCAM message control program (MCP) • 

| However, in order to obtain the benefits of TCAM SNA and to maintain an 
| acceptable operator interface, it is usually necessary to change the 
l CICS/VS application programs to use DFHTC CONVERSE and WRITE, LAST 
| facilities so that the MCP is provided with sufficient information about 
I the transaction to maintain the optimum SNA message flows. 

There are basic differences between TCAM and BTAM design methods. 
CICS/OS/VS was designed to operate in the BTAM environment. The 
CICS/OS/VS/TCAM Interface, although resolving most of the differences, 
must impose some restrictions when CICS/OS/VS is run in a TCAM 
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environment. These restrictions as well as some of the ramifications of 
selecting various user options are addressed in this section. Also 
described are the user facilities available and how the user implements 
and operates the system through the interface. 


CICS/OS/VS WITH TCAM SNA 

TCAM can be used to provide an SNA network without the use of VTAM. The 
CICS/OS/VS/TCAM interface has an enhanced data stream support which 
enables a suitably written TCAM message control program (MCP) to control 
the SNA session. The TCAMFET=SNA operand in DFHTCT TYPE=LINE allows 
TCTTEs to be specified for SNA devices. The user must be prepared to 
write an appropriate TCAM SNA message control program to complement the 
j CICS/VS support and the SNA devices attached to the system. In order to 
| obtain a good operator interface, the CICS/VS application programs 
| should be designed to inform the MCP of their intentions. Thus, it is 
| better to design the MCP and the application programs together. 

| Sample TCAM SNA MCPs are provided in Appendix F. The second sample 
| MCP (DFHSPTM2) uses the information passed in the CCB to optimize the 
| message flows to the actual logical unit. This represents transaction- 
| oriented processing. 

The support provided by TCAM for SNA devices running under CICS/VS is 
a data steam support. Both the SNA character string (SCS) and the 3270 
data streams are supported. 

In order to understand how CICS/VS works with TCAM in an SNA 
environment, it is important to understand the TCAM SNA structure. The 
device message handler (DMH) is the logical unit in SNA terms. All data 
flow control (DFC) , session startup and takedown, and response handling 
are provided in the DMH. There is no CICS/VS control of these SNA 
functions and the application programmer need not be concerned with 
these functions. For a more detailed discussion of the TCAM SNA 
functions provided, refer to the OS/VS TCAM System Programmer's Guide . 


PROTOCOL MANAGEMENT 


Many different protocols may exist in an SNA network. The various 
protocols are established on a session basis by using the bind image. 

The decision on which protocols to use with which SNA session belongs to 
the system programmer, who should understand the requirements of the 
installations application programs before deciding on a specific 
protocol. 

Some of the more common of these SNA protocols ares bracket, half¬ 
duplex flip-flop (HDX-FF) , and half-duplex contention (HDX-CON) . The 
enforcement of these protocols is a function of the DMH. 

There are two ways of performing protocol management in a 
CICS/OS/VS/TCAM system: 

• Device message handler control 

• Transaction control 

These methods are discussed below. 
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Device Message Handler Control 

This type of protocol management is used when the transaction wishes to 
be completely unaware of the device with which it is communicating. 
Although the communication control bytes are passed between CICS/VS and 
TCAM, they are not used to control the SNA session. All the protocol 
control is provided in the DMH. The appearance at the outboard LU is at 
the option of the system programmer (MH writer) instead of the 
application programmer. 
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Chapter 6.2. User Exits for CICS/VS 

Management Programs 

This chapter contains information on the conventions and restrictions 
that must be observed when the system programmer writes a user exit 
routine for a CICS/VS management program. In addition, Figure 6.2 
illustrates the contents of the general register and the exit 
identifications, which the system programmer may require when writing 
the user exit routine. 

CICS/VS provides a technique for incorporating user-written source 
code into the majority of the CICS/VS management programs. This source 
code may extend various CICS/VS management functions. Provided the user 
conforms to certain restrictions and conventions, this facility should 
minimize the impact of CICS/VS source code modifications when installing 
new releases of CICS/VS. 

Note ; Exit routines may only be written in the macro interface to 
CICS/VS. User exit routines written in the command interface are not 
supported. 

To include a user—written exit routine in a particular CICS/VS 
management program, the user must place the source code in a CICS/VS 
source library member (OS/VS) or book poS/VS) which has the naming 
convention; 

DFHxxEXT 

where xx is the two—character designation for the management program 
into which the user—written code is to be included. The acceptable two- 
character designations are; 

KC (Task Control) 

SC (Storage Control) 

PC (Program Control) 

TC (Terminal Control) 

FC (File Control) 

IC (Interval Control) 

TD (Transient Data Control) 

TS (Temporary Storage Control) 

TB (Transaction Backout — see “Data Base Backout and Message 

Recovery* in Chapter 4.8.) 

DB pynamic Transaction Backout) 

TZ (VTAM Terminal Control) 

The code provided by the user in a given member (book) may consist of 
more than one routine (function) , depending upon the number of linkages 
provided in the particular CICS/VS management program. For example, 
file management provides linkage to user—written exit routines both 
before and after an input operation. Thus, user—supplied code in the 
member (book) DFHFCEXT might contain two routines, each identified by a 
unique symbolic name. 

Linkage from the CICS/VS management program to the appropriate user- 
written exit routine is accomplished by one of the following methods; 

1. An assembler RAL instruction that uses the user—defined symbolic 
name as the “branch to“ label and general register 14 as a return 
register. 
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2. Register 14 is loaded with an address constant for the user defined 
symbolic name and a BALR 14,14 instruction is issued. 

Note : The user—written exit routines are located at the end of the 

management programs. The length of some programs is such that the exit 
routines are not addressable by the program B s base register (s) . This 
situation forces the use of method 2 above, and requires the exit 
routine to establish its own addressability upon gaining control. 

Under method 1, at least some beginning part of the user exit routine 
is addressable by a management program base register. Another base 
register may be required for the rest of the exit routine. 

The symbolic name of the exit routine is specified in the appropriate 
operand when the management program is generated. For example, in 
response to the 


DFHSG PROGRiM=SCP, * 

XTYPREQ=ORANGE 

specification, user exit linkage in the form of an assembler language 
BAL 14,ORANGE 

instruction is generated in the appropriate place in the storage control 
program. In this example, source code similar to the following should 
have been provided by the user in the member DFHSCEXT: 

ORANGE DS OH USER EXIT ENTRY 


User code 


© 

BR 14 

On entry to a user exit routine, registers can be saved in the CSA 
| register save area (CSAOSRSA) . The CSA may be used for saving 
| registers, provided no other routines or services for CICS/VS modules 
| are called by the exits. The method has the advantage of producing 
| "read-only" code. 

The following example shows the use of OS/VS or DOS/VS SAVE and 
RETURN macro instructions to save registers 5 through 9 and to use 
register 5 as a base register. 


ORANGE DS OH 

SAVE (5,9) 

BALR 5,0 
USING *,5 


USER EXIT ENTRY 
SAVE REGS 5,6,7,8,9 
IN CSAOSRSA 
USE REG 5 AS BASE REG 


RETURN (5,9) RESTORE REGS 5,6,7,8,9 

AND RETURN VIA REG 14 

The exit routine should not issue any OS/VS or DOS/VS macro 
instructions. This includes releasing control to another task which 
might use this same (or another) exit routine. The user must take care. 
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however, especially if the routine could lose control to another CICS/VS 
task* 

When creating the CICS/VS management program assembly jobs during 
system generation, a COPY DFHxxEXT statement is included immediately 
preceding the Assembler END statement. In the above example, the 
following would be generated: 


COPY DFHCSADS 
COPY DFHTCADS 


COPY DFHSCEXT 
END 

When coding user exits for CICS/VS management programs, the user 
should adhere to the following conventions and guidelines: 

1* Because user exits are essentially •in line" with the management 
programs, the programmer should be familiar with the functions of 
the program to which the exit code is being added. 

2. Unless the original contents are restored before return to the 
CICS/VS management program, user—written exit routines must never 
alter the contents of registers that provide addressability to 
control blocks. 

3. User-written exit routines must never violate restrictions of the 
management programs. For example, an exit routine in storage 
control cannot issue a DFHSC GETMAIN request. Exit routines 
should not issue requests for CICS/VS services. In particular, 
user exits must not invoke any CICS/VS functions which could cause 
the task to be put into a CICS wait state. Certain CICS/VS 
management functions (for example, DFHZCP) rely on not being 
interrupted during the processing of an item. This restriction 
usually extends across a user exit. 

4. User—written exit routines must be coded in assembler language. 

5. Symbolic names (labels) used to define user exit entry points must 
not be duplicates of labels in the CICS/VS management program. 

6. Base register addressability for the user-written exit routine 
exists only to the extent of the base register (s) associated with 
the management program. The user exit must never alter the base 
register (s) of the management program. The user is responsible for 
saving registers and establishing addressability. 

7. Register contents differ depending on the management program and 
particular exit function. However, the contents of the following 
registers are always constant: 


Register 


Contents 


14 Return address 

13 CSA address 

12 TCA address 

Depending on the management program and functional user exit, certain 

general registers contain information that the user may find useful. 
Figure 6.2 is a summary, by exit, of the contents of these registers: 
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PROGRAM 

EXIT ID 

LINKAGE LOCATION 

REGISTER 

REGISTER 


DFHDBP 

XINIT 

On entry to 

DBRREG 

Points to record 

(See Chapter 4.4) 

DFHDBP 






XINPUT 

After each log 

DBRREG 






record received (execpt DL/I) 





XFERROR 

Error returned 

DBRREG 

Points to FWA 



from FCP 

FWACBAR 





XDERROR 

On DL/I error 

DBRREG 




DFHKCP 

XDSPCHR 

Before dispatch 

TCACBAR 

Address 

of 

TCA being 





dispatched 



XTYPREQ 

Before request 
analysis 





DFHPCP 

XFETCH 

After load 

PPTCBAR 

Address 

of 

PPT entry 





for loaded 

program 




PCECREG 

Entry point address 
of loaded program 

DFHICP 

XICEEXP 

After expiration 

ICECBAR 

Address 

of 

Interval 



of time interval 


Control 

Element (ICE) 





just expired 


XTYPREQ 

Before request 
analysis 

N.A. 

N.A. 



DFHSCP 

XTYPREQ 

Before request 
analysis 

N. A. 

N.A. 



DFKTCP 

XATTACH 

Before task attach 

TCTTEAR 

Address 

of 

TCTTE 




TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 


XOUTPUT 

Before output event 

TCTTEAR 

Address 

of 

TCTTE 




TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 


XINPUT 

After input event 

TCTTEAR 

Address 

of 

TCTTE 




TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 


XTCMOUT 

Before output event 

TCTTEAR 

Address 

of 

TCTTE 


(TCAM) 

TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 


XTCMIN 

After input event 

TCTTEAR 

Address 

of 

TCTTE 


(TCAM) 


TCTLEAR 

Address 

of 

TCTLE 




TIOABAR 

Address 

of 

TIOA 

DFHZCP 

ZATTACH 

Before task attach 

TCTTEAR 

Address 

of 

TCTTE 


(VTAM) 


NIOABAR 

Address 

of 

TIOA 


ZOUTPUT 

Before output event 

TCTTEAR 

Address 

of 

TCTTE 


(VTAM) 


NIOABAR 

Address 

of 

TIOA 


ZINPUT 

After input event 

TCTTEAR 

Address 

of 

TCTTE 


(VTAM) 


NIOABAR 

Address 

of 

TIOA 


Note s: 

1. For ERASEAUP and READB requests, there is no associated TIOA. 

| 2. The exits for TCAM have two return points: 00 (R14) and 04 (R14) t 

| which determine the action that CICS/VS has to take. Great care 

| should be taken to return to the correct offset from register 14; 

| in particular, the output routine will not perform its normal work 

| unless return is made to offset 4 from register 14. 

Figure 6.2 (Part 1 of 2) . User Exit Information 
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Chapter 6.5. Modifying the Terminal Control 

Table 


This chapter provides reference information on the macro and operands of 
the terminal control macro instruction interface pFHTC CTYPE macros) . 
The functions and relevant macro instructions of this interface ares 

• Scanning the terminal control table pFHTC CTYPE=L0CATE) 

• Changing the status of a logical unit PFHTC CTYPE=STATUS) 

• Checking the outcome of any of the above operations pFHTC 
CTYPE=CHECK) 

• Issuing a VTAM indicator pFHTC CTYPE=COMMAND) 

The DFHTC CTYPE macros should only be used by the system programmer 
when user—specific routines are written to handle recovery and error- 
correction conditions. 

These macros are only available for use with the macro—level 
application programming interface, and only with assembler language. 

A description of the DFHTC CTYPE macros and operands follows. 

Note s The system programmer must specify DFHTCTZE CICSSYST=YES and 
| DFHTCA CICSSYST=YES in order to generate the system portions of the 
TCTTE and TCA DSECTS, which are required for any program that uses the 
DFHTC CTYPE requests and commands. 


TERMINAL LOCATE FUNCTION — DFHTC CTYPB=LOCATE 


The DFHTC CTYPE=LOCATE macro instruction may be used by the system 
programmer to s 

• Find the TCTTE for a particular logical unit 

• Retrieve LDC information associated with a TCTTE 

• Scan the TCT from top to bottom 

The locate function allows the system programmer to perform any of 
the above operations without being concerned with the structure of the 
terminal control table. For example, the system programmer can use the 
function to keep track of the availability of certain printers to 
schedule output to them, instead of implementing table-dependent 
application programs to do so. 

Note : Alteration of terminal IDs by the user during CICS/VS execution 
may preclude determining the location at the expected terminal following 
the change. 
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DFHTC 




| CTYPE=LOCATE 
| [,ERROR==symbolic—address ] 

| [,INVADDR=symbolic-address] 
I [ r INVID=symbolic-address] 

| [ ,LASTTRM=symbolic-address] 
| [ ,LDC- (DEFAULT j YES} ] 

| [,NORESP=symbolic—address] 

| [,TERM={FIRST|NEXT|ID}] 


CTYPE=LOCATE 

requests the address of a terminal entry in the TCT and/or the 
address of a LDC entry in the system LDC table* 


ERROR^syrabolic-address 

specifies the entry label of the user—written routine to which 
control is to be passed if an error occurs. Errors passed to 
this exit routine are those not handled by INVADDR # INVID, 
INVREQ, or INVLDC. 


I NVADDR= symbo lie—addr e s s 

specifies the entry label of the user-written routine to which 
control is to be passed if the address specified in TCATPTA is 
not within the limits of the terminal control table, properly 
aligned, or zero for a TERM=NEXT form. This operand is only 
applicable when an address is required in TCATPTA. 


INVID=symbolic—address 

specifies the entry label of the user—written routine to which 
control is to be passed if the terminal ID specified in TCATPTA 
is not located in the TCT. This operand is only applicable to 
TERM=ID. 

specifies the entry label of the user-written routine to which 
control is to be passed if the address that was preset in 
TCATPTA was that of the last terminal entry in the table. This 
operand is only applicable to TERM=NEXT. 


LDC=YES j DEFAULT 

requests LDC information (the mnemonic, the numeric value, 
and/or the entry in the system LDC table or the extended local 
LDC list) associated with a specified TCTTE. If the LDC 
mnemonic is found, CICS/VS returns (in TCATPLDA) the address of 
the LDC entry and (in TCATPLDC) , the LDC numeric value. The 
LDC operand causes CICS/VS to search the local LDC table for 
the LDC mnemonic. If the LDC mnemonic is found in the local 
table, the LDC numeric value is supplied from the local table 
(if the local table does not have the numeric value, the LDC 
value is taken from the system table) . TCATPTA can be 
preloaded with the address of the TCTTE to be used; if TCATPTA 
is preloaded, the TERM operand cannot be specified in this 
request. This operand does not apply to 3614 logical units. 

Note : If an extended local LDC list exists for the terminal 

specified in the LDC operand, TCATPLDA is set to point to the 
extended local LDC list entry. 
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• All timings are in milliseconds “measured* on the standard 
processor. 

• All timings are approximate. They are intended to represent medium 
size installations in normal situations running applications of 
average complexity. Where systems are generated to include all 
functions, and where the data base structure is very complex , 
timings will be higher than those quoted. For small simple 
systems, timings can be less. A sensible level of tuning is 
assumed, that is to say, the system programmer should be familiar 
with the information in the appropriate CICS/VS System Programmers 
Guide and should have put the more significant guidelines into 
action. 

• Timings represent the current release of CICS/VS unless 
specifically stated otherwise. 

• Items marked *—* indicate that reliable data is not yet available. 

• Items marked "NA“ indicate that the particular function does not 
exist (for example, VSAM ICIP under DOS/VS) . 


TABLE 1. 



r 

i 

Transaction Type 

| DOS/VS 

OS/VS1 1 

OS/VS 2 (MVS) 

—i 


1 

1 

ECHO 

i 

i 

1 

1 




1 

BTAM 3270 BSC 

| 22.0 

22.5 | 

25.0 



1 

3270 Local 

| 10.0 

14.5 | 

16.0 


1 

1 

Start/Stop 

I 19.5 

21.0 | 

23.0 


1 

1 

1 

Start/Stop point-to-point 

| 14.2 

I 

15.5 | 

| 

17.0 



1 

1 

VTAM 3270 Local 

| 17.5 

22.0 | 

20.0 



1 

3270 BSC 

| 18.5 

22.4 | 

23.0 



1 

3270 SNA (3274/3278) 

| 15.0 

18.0 | 

20.0 



1 

3600—SNA 

| 15.0 

18.0 | 

20.0 


1 

1 

379 0—SNA 1 

| 20.0 

28.8 | 

32.0 


1 

1 

| 

3790—3270 emulation 1 

| 21.0 
i 

27.6 | 

• 

31.0 



1 

1 

Authorized Path VTAM ♦ CICS/VS 

1 

| NA 

1 

NA | 

12.5 



1 

1 

HPO (3600, 3270 SNA) 

1 

i 

1 

1 




1 

1 

Primed storage — deduct from 

1 

| NA 

-1.0 | 

-1.0 


1 

1 

1 

all ECHO values except HPO 

i 

i i 

1 

1 1 




I 

1 

| 

Conversational ECHO 

I I I 

| —USE ECHO VALUES — 

iii 



1 

( 

Automatic Initiation 

i 

1 4.5 

4.9 | 

5.2 



1 


1 

* 1 


__j 


Table 1. Base Transaction Timings {in milliseconds) 


Notes : 

*■ 

1. Includes processing of mandatory definite response from 3790 when 
CICS/VS sends End Bracket on the (last) write. 
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2. All values given assume the ECHO is written in assembler Qlacro 
Level) , occupies the first position in the program control table, 
and is resident in virtual storage. 

The CICS/VS application function timings given in Table 2 (below) are 
in milliseconds and represent "average" systems. Variations will occur 
because of different options in the operating systems, access methods, 
CICS/VS, and with the size of the installation. Hence, all values are 
approximate but are believed to be individually correct to within plus 
or minus 10% for the majority of configurations. 

The timings given represent CICS/VS Version 1, Release 4, unless 
otherwise stated. 

The "NA" symbol indicates that the pathlength data is not applicable 
to a certain function, and *—" indicates that information is not yet 
available for that function. 

No guarantee is given that these timings accurately represent any 
particular environment. 
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TABLE 2. 


I 

I 

I 

I 


r 

Application Function 

| DOS/VS 1 OS/VS1 1 OS/VS2 
| (Times in milliseconds) 

—i 

i” 

Terminal Control 

i 

i 

i 

i 

i 

i 

i 


BTAM 

3270 Local READ 

| 3.4 

1 

| 5.1 

| 6.1 




WRITE 

| 3.5 

| 3.7 

| 4.8 




3270 BSC READ 

| 6.1 

| 5.6 

| 6.8 




WRITE 

| 10.3 

| 9.2 

| 10.4 



VTAM 

3270 Local READ 

1 7.1 

| 9.7 

| 6.7 




WRITE 

| 6.4 

| 8.9 

| 7.0 




3270 BSC READ ' 

| 7.5 

| 9.0 

| 8.0 




WRITE 

1 5.4 

| 6.3 

1 7.7 




3270 SNA READ 

| 7.0 

1 7.5 

| 7.7 




WRITE 

1 4.7 

| 6.0 

| 6.2 




3790 READ 

| 7.0 

1 7.5 

1 7.7 




WRITE 

1 4.7 

l 6.0 

| 6.2 




3600 READ 

| 7.0 

1 7.5 

| 7.7 




WRITE 

1 4.7 

I 6.0 

| 6.2 
t 




VPACING RESPONSE 1 

1 

| 2.8 

1 

| 3.7 

i 

| 4.2 




PUNSOL=YES (L3270 and 

| 2.0 

| 2.3 

| 2.5 




BSC only) 

1 

i 

i 




RESPONSE to input data 

| 4.2 

| 5.5 

1 5.7 




RESPONSE from terminal 

1 4.7 

| 5.8 

| 6.8 



Deduct 

for authorized path 2 

i 

i 

i 

i 

1 

i 




READ 

| NA 

| NA 

| 1.2 




WRITE 

| NA 

t NA 

t 

| 1.8 

1 




MSGPREQ=PROTECT (PCT) 

1 

i 

1 

i 

1 




Add to ECHO (VTAM only) 

i 

| 27.0 

| 

1 



Basic Mappinq Support 

1 

i 

1 

1 

1 

1 



(excluding terminal I/O pathlengths) 

i 

1 

1 

1 

1 

I 



Output 

- DATA=YES BASE 

| 1.5 

1 1-7 

1 1*7 




Add (per field) 

| 0.12 

| 0.12 

| 0.12 




Subtract (per null Field) 

| -0.05 

1 

| -0.05 

1 

1 -0.05 

i 




DATA=ONLY BASE 

| 1.5 

1 1-7 

1 1-7 




Add (per field) 

| 0.035 

| 0.035 

| 0.035 




Add (per DATA field) 

| 0.08 

| 0.08 

| 0.08 




Subtract (per null DATA 

| -0.05 

| -0.05 

| -0.05 




field) 

1 

I 

1 

i 

1 

t 




DATA=NO BASE 

| 1.3 

| 1.5 

I 1.5 




Add (per field) 

| 0.07 

| 0.07 

| 0.07 




Add (per FORMAT field) 

| 0.05 

| 0.05 

| 0.05 




Primed storage — deduct 

| NA 

| 0.2 

| 0.2 




from BMS BASE 

1 

i 

1 

i 

1 

i 



Input 

(TYPE=MAP or TYPE=IN) 

1 

1 

1 

1 

1 

1 




BASE 

| 1.8 

| 2.0 

| 2.0 




Add (per changed field) 

| 0.12 

| 0.12 

| 0.12 


L. 


Primed storage, deduct BASE | NA 

1 

| 0.3 

1 

| 0.3 

1 



| Table 2. (Part 1 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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1“ 

Application Function 

| DOS/VS 
| (Times 

1 

in 

OS/VS1 | OS/VS2 
milliseconds) 

—i 

1" 

Map location (excluding PPT search) 

1 

1 

1 

1 


i 

i 




Resident in virtual storage 

| 0.25 

1 

0.25 

i 

0.25 



Not resident in virtual 

| 3.5 

1 

7.0 

i 

8.0 



storage 

i 

i 

1 

1 


i 

1 




Proqram Control 

V 

i 

1 

1 

1 


1 

i 

■ 




a) Resident programs and maps 

t 

1 

1 


1 

i 




(and non-resident programs and 

i 

1 


i 




maps already in core) 

i 

1 


i 




LINK+RETURN 

| 0.42 

1 

0.42 

i 

0.42 



XCTL 

| 0.12 

1 

0.12 

i 

0.12 



LOAD 

| 0.25 

i 

1 

0.25 

i 

i 

0.25 



b) Non-resident programs and maps 

i 

i 

1 

1 


i 

i 




LINK+RETURN 

| 2.4 

1 

7.4 

i 

8.4 



XCTL 

| 2.1 

1 

7.1 

i 

8.1 



LOAD 

| 2.0 

1 

7.0 

i 

8.0 



DELETE 

1 ~ 

1 

— 

i 

— 



(These exclude the PPT search — see 

i 

1 


i 




Table Search pathlengths, below) 

\ 

i 

1 

1 


i 

i 




c) High-level language support 

I 

1 

l 

1 


1 

i 




(macro level) 

1 

l 


i 




PL/I per program called 

1 1.1 

1 

1.1 

i 

1.1 



per macro call 

| 0.02 

1 

0.02 

i 

0.02 



COBOL per program called 

| 0.45 

1 

0.45 

i 

0.45 



per macro call 

| 0.04 

i 

1 

1 

0.04 

i 

i 

0.04 



d) Command—level language support 

1 

1 

1 


1 

i 




These timings should be added 

i 

1 


i 




to the macro level timings for 

i 

1 


i 




the same language. For RPG II add 

i 

1 


i 




to assembler macro data. 9 

i 

I 

1 

1 


i 

i 




PL/I ECHO 

| 1.3 

1 

1 

1.3 

1 

i 

1.3 



CICS/VS calls 

| 6 % 

I 

1 

1 

6% 

i 

i 

6 % 



Assembler ECHO 

1 

I 1.3 

1 

1 

1.3 

1 

i 

1.3 



Other calls 

| +6* 

I 

1 

1 

+6* 

i 

i 

+ 6* 



COBOL ECHO 

| 2.2 

1 

1 

2.2 

l 

i 

2.2 



Other calls 

| 6 % 

1 

1 

1 

6 % 

i 

• 

6* 



RPG II ECHO 10 

| 11.0 

1 

1 

NA 

I 

i 

NA 


L_ 

Other calls 

| +6* 

\ 

1 

1 

NA 

i 

i 

NA 



| Table 2. {Part 2 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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I 

I 

I 

I 


r 

Application Function 

| DOS/VS 
| (Times 

| OS/VSl | OS/VS2 
in milliseconds) 

—i 

r 

Storaqe 

Control 

i 

i 

1 

1 

1 

1 

i 

i 

1 

— t 


GETMAIN 

+ FREEMAIN (normal) 

| 0.3 

| 0.3 

| 0.3 



If one 

or more new pages are 

i 

i 

i 



needed, 

adds 

I ♦0.7 

| +0.9 

| +0.9 



^Primed 

storage 

| NA 

i 

I 0.07 

a 

| 0.07 

i 



Journalincr 

1 

1 

| 

1 

i 

» 

1 

i 

i 



GETJCA 

(not requiring new page) 

| 0.17 

| 0.17 

| 0.17 



PUT 

STARTIO=YES - DISK 

| 2.4 

| 3.8 

| 4.0 




- TAPE 

| 2.4 

| 3.6 

| 3.7 




STARTIO—NO 3 - no I/O 

I 0.13 

| .0.13 

| 0.13 




- DISK I/O 

| 3.3 

| 7.3 

| 7.8 



WRITE 

STARTIO—YES - DISK 

| 1.9 

| 3.5 

| 3.7 




- TAPE 

| 1.9 

| 3.4 

| 3.5 




STARTIO=NO 3 - no I/O 

| 0.13 

| 0.13 

| 0.13 




- I/O 

| -USE STARTIO=YES 

values- 



WAIT (block to be written) 

1 3.1 

| 4.7 

| 5.0 



(none to be written) 

| 1.0 

1 

I 1.0 

1 

| 1.0 

1 



File Control 

1 

1 

1 

1 

| 

1 

1 

1 



ISAM 

GET - INQUIRY 

1 

I 3.5 

| 13.5 

| 16.0 




PUT - ADD 

1 — 

| 32.0 

| 32.5 




GET - UPDATE 

| 3.9 

| 14.5 

| 16.0 




PUT - UPDATE 

1 5.4 

| 21.1 

| 25.2 




Cylinder index not 

1 

1 

1 




in core, add 

| +2.0 

| +5.5 

| +5.8 




CICS/VS logging (UPDATE) , 

1 

1 

1 




add: 

| +0.2 

| +0.2 

| +0.2 




Logging forcing I/O, add 4 : 

| +3.3 

| +7.0 

| +7.5 




Primed storage 

1 

1 

1 




GET (UPDATE) 

| NA 

| -0.4 

| -0.4 




PUT/GET (INQUIRY) 

| NA 

1 

| -0.3 

t 

| -0.3 

1 



BDAM 

GET - INQUIRY 

| 2.4 

1 3.7 

| 5.30 




PUT - ADD 

| 5.8 

| 5.5 

| 8.8 




GET - UPDATE 

| 3.0 

| 7.4 

| 10.6 




PUT - UPDATE 

| 2.8 

| 4.9 

| 6.5 




Logging (on update) 

| +0.8 

( +0.8 

| +0.8 




Logging forcing I/O, add 4 : 

| +3.3 

| +7.0 

| +7.5 




Primed storage 


i 

1 




UPDATE operations 

| NA 

| -0.3 

| -0.3 


L 


INQUIRY 

| NA 

1 

| -0.1 

1 

| -0.1 

1 

_t 


| Table 2. (Part 3 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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r- 

Application Function 

| DOS/VS | 0S/VS1 | OS/VS2 
| (Times in milliseconds) 

“1 

r 

VSAM (DOS/VS VSAM) (See Note 5) 




“1 


KSDS GET - INQUIRY 

| 4.9 

| 4.8 

| 6.2 



PUT - ADD 11 

I 9.0 

| 9.6 

| 10.5 



PUT — mass insert 

18.9+4.ON 

| - 

1 — 



of N records 






GET - UPDATE 

| 5.2 

| 5.0 

| 6.4 



PUT - UPDATE 

| 3.9 

| 4.1 

| 4.9 



DELETE 

| 10.5 

| — 

| — 



Each index I/O, 






add 6 : 

| +1.7 

| +2.5 

| +3.7 



Each index level 






other than first level 






or sequence set, add 6 : 

| +1.0 

| +1.0 

| +1.0 



Control interval splits 7 

I 17.0 

1 — 

1 — 



Primed storage 






UPDATE 

| NA 

| —0.3 

| -0.3 



INQUIRY 

| NA 

| -0.2 

| -0.2 



ESDS and RRDS 






GET - INQUIRY 

| 3.9 

| 3.8 

| 4.8 



PUT - ADD 11 

| 8.4 

| 8.5 

| 9.7 



GET - UPDATE 

| 4.1 

| 4.2 

1 5.1 



PUT - UPDATE 

| 3.8 

| 4.1 

l 4.9 



BROWSE - N records 

| 9.0 + 






| 3.8N 

j - 

| — 



Logging (KSDS , ESDS , 






RRDS) 

| (Use logging pathlengths for 




| BDAM 

, above) 

i 




VSAM ICIP (OS/VS2 only) 


i 

i 




KSDS GET 

| NA 

| NA 

| 3.5 



PUT 

| NA 

| NA 

| 3.0 



per index I/O 

| NA 

| NA 

| 2.0 



ESDS GET 

| NA 

| NA 

| 3.2 



PUT 

| NA 

| NA 

1 

| 3.0 



VSAM CHECK 

| 0.1 

| 0.1 

| 0.1 



RELEASE 

| 0.2 

| 0.3 

I 0.3 



Temporary Storaqe 


i 




Main storage GETQ/GET 

| 0.25 

| 0.25 

| 0.25 



PUTQ/PUT 

| 0.40 

| 0.40 

I 0.40 



PURGE 

| 0.52 

| 0.52 

| 

| 0.52 



Auxiliary GETQ/GET {no I/O) 

| 0.15 

| 0.30 

| 0.30 



storage® GETQ/GET (I/O) 

| — 

| 3.5 

| 4.6 



PUTQ/PUT (no I/O) 

| 0.28 

| 0.4 

f 0.4 



PUTQ/PUT (I/O) 

| — 

1 3.7 

| 4.8 


L 

PURGE 

| 0.28 

| 0.26 

\ 

1 

| 0.28 

_I 


| Table 2. {Part 4 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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Application Function 

| DOS/VS | OS/VS1 | OS/VS2 
| (Times in milliseconds) 

Transient Data 

1 

1 

1 

I 

1 

I 

Intrapartition with VSAM 

I 

1 

1 

1 

1 

1 

GET 

| 3.2 

i 4.0 

| 5.0 

PUT 

| 3.6 

| 4.4 

1 5.4 

GET/PUT (no I/O) 

I 0.22 

| 0.22 

| 0.22 

First GET 

| 6.0 

| 7.6 

i 

| 9.6 

i 

with BDAM 

i 

i 

i 

i 

i 

i 

GET first item 

| 7.0 

| 6.7 

| 8.7 

GET subsequent 

| 3.2 

| 3.3 

| 4.3 

PUT first item 

| 9.0 

| 25.8 

| 29.8 

PUT subsequent 

1 3.5 

| 11.4 

| 12.9 

PUT to a full track) — 

l 

| 22.0 

| 25.0 

Extrapartition 

i 

1 

1 

i 

i 

GET (no I/O) 

1 — 

1 - 

| — 

PUT (no I/O) 

| 0.33 

| 0.33 

| 0.33 

GET (I/O) 

| — 

1 — 

1 - 

PUT (I/O) 

| 1.6 
i 

| 2.4 

i 

t 3.6 

i 

Intersvstem Communication 

i 

i 

i 

i 

1 

i 

(See Note 5 before using) 

i 

i 

i 

i 

i 

Simple functions: 

i 

i 

i 

i 

i 

i 

Local system with BID 

) 28.6 

| 32.7 

| 38.8 

without BID 

| 17.0 

| 19.4 

| 22.9 

Remote system with BID 

| 27.0 

| 30.4 

| 35.4 

without BID 

| 17.3 

i 

| 19.1 

| 

| 21.7 

Update function with 

i 

i 

1 

1 

1 

1 

synchronization: 

i 

1 

1 

Local system with BID 

| 56.9 

| 64.6 

| 76.2 

without BID 

| 45.3 

| 51.3 

| 60.3 

Remote system with BID 

| 54.6 

| 61.7 

| 70.7 

without BID 

| 44.9 

| 50.4 

| 57.0 

Table Search 

i 

i 

i 

i 

i 

1 

1 

1 

1 

Sequential search (N=number of | 

1 

t 

1 

1 

entries searched before the 

i 


1 

current entry is found) 

i 

i 

1 

DFHDCT 

i 

i 

1 

intrapartition entries 

| 0.009 

| 0.009 

| 0.009 

extrapartition entries 

| 0.007 

| 0.007 

| 0.007 

DFHFCT 

| 0.004 

| 0.004 

| 0.004 

DFHPCT 

| 0.006 

| 0.006 

| 0.006 

DFHPPT 

| 0.006 

| 0.006 

| 0.006 
t 

Indexed search 

! 

1 

1 

1 

1 

All tables 

1 

1 

1 

If number of entries is 

1 

1 

1 

between 2N—1 and 2N 

| 0.013N 

1 

| 0.013N 

1 

| 0.013N 

1 


| Table 2. (Part 5 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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Application Function 


r- 

1 Trace per call 

i 

| 0.06 

i 

| 0.06 

i 

| 0.06 


| or as a percentage of 

| total pathlength 

1 

| 15% 

| 

1 

| 13% 

1 

1 

| 10% 

1 


1 Paqe Faults (that cause I/O) 

1 

1 

1 

1 

1 

1 

1 

1 


| Average values are: 

1 1.5 

i 

| 2.5 

1 

| 3.0 

1 


1 Miscellaneous 

1 

i 

i 

1 

1 

i 

i 


t Job accounting (DOS/VS only) 

| MVS system resource manager — 

| +7% 

1 

1 

| NA 

1 

1 

| NA 

1 


| approximately per address space per | 

1 



| cycle: 

i_ 

| NA 

| NA 

| 1.5 

_I 


DOS/VS | OS/VS1 | OS/VS2 
(Times in milliseconds) 


| Table 2. (Part 6 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 


Notes : 

1. A VPACING RESPONSE can usually be pro—rated across several WRITES; 

for example, if there is a pacing response sent on every third 
WRITE, 2*8/3 (0.93) must be added to each transaction. 

2. These READS and WRITES are additional to those included in ECHO 
paths. VTAM options will not always be the same as those used in 
the ECHO. 

3. If STARTIO=NO is used, and N is the average number of records in 
the block, 

(N-l/N) x (1/N) x START lO=YES 

should be used. The PUT plus STARTIO=NO times include the 
execution of the timer SVC. 

4. A significant amount of processing is done at a sync point (often 
at the end of a task) . A value of 4.0 milliseconds should be 
added, but this can be prorated across the number of updates 
between sync points. If I/O is forced because thfe buffer shift—up 
value is exceeded, the START10=YES values should be used instead. 

5. If FASTTR=YES is specified, CICS/DOS/VS VSAM pathlengths may be 

| reduced by up to 0.9 milliseconds per physical I/O, depending on 

| the proportion of CCWs that do not have to be translated. 

6. The VSAM KSDS times assume that each data set has a top-level index 
and a sequence set index. They also assume that no index I/Os take 
place (only the data I/O) . Values are given to take account of 
index I/Os and additional index levels. These values should be 
added, as appropriate, to the GET (INQUIRY and UPDATE) , PUT (ADD) , 
and DELETE values, but not to PUT (UPDATE) . For example, if an 
OS/VS1 data set has 3 levels of index (two + sequence set) and only 
sufficient buffers allocated to keep the top level in core, the 
time for a GET (INQUIRY) would be: 

| 4.8 4 2 x 1.0 + 2 x 2.5 

1 =11.8 milliseconds 
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The values for additional indexes may vary considerably depending 
on the number of records in the control interval and on the 
position of the index required in the control interval. Variations 
from 0.5 milliseconds to 2.0 milliseconds can be expected. 

7. The control interval split values are approximate. Considerable 
variation can be expected. 

8• I/O only occurs when the VSAM control interval becomes full (PUT) , 
or when a new control interval is read in (GET) . To obtain an 
average path with *N* records per control interval, 

(N—1/N) x no I/O timing + (1/N) x I/O timing 
should be used. 

| 9. Where a BMS SEND command is followed by a BMS RECEIVE without an 

| intervening WAIT, a further 2 milliseconds should be added. 

10. The 11.0 milliseconds addition makes an allowance for the loading 
of the RPG II program. For large programs (more than 12K bytes) 
this value may need to be increased. Sub—programs that are called 
will always be loaded and allowance should be made for these by 
using the program control program data. For medium—sized programs 

(between approximately 4K and 12K bytes) two loads should be 
allowed for. 

11. PUT/ADD assumes that the control interval must be read in before 
data can be entered. This will not always be necessary if, for 
example, the control interval is in core from a previous operation. 

| 12# The intersystem communication (ISC) facilities allow the user to 

l access resources on a remote system using file control, transient 

| data, temporary storage, DL/I, and interval control. The processor 

I times necessary to execute these functions on a remote system can 

| be calculated as a sum of several times on both the local system 

| and the remote system. 

| The times on the remote system are the times taken to: 

| a. Execute the requested function at the macro level, and 

| b. Execute the ISC code on the remote system. 

| The times on the local system are the times taken to: 

| c. Execute the additional code necessary to perform the function 

| at the command level 

| d. Execute the ISC code on the local system. 

| Items a. and c. can be found elsewhere in this table. The BID 

| times should be used when the system that initiates the request has 

| to BID for the request. 

| "Simple" implies a simple one-command fmiction (for example, a file 

| control GET) where no synchronization is necessary. For an 

j "update" type of operation, synchronization is usually necessary. 

| This is included in the times. Note that for an update operation, 

| the times under "update operation include the ISC overhead for both 

| the GET and PUT parts of the operation. 

| For MVS and VTAM authorized path, the DOS/VS figures should be used 

| and increased by 5%. 
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TABLE 3. 


i- - -1 

| ACCESS METHOD/ | DOS/VS | OS/VS1 | OS/VS2 | 

| TERMINAL | | | | 


1 

1 B | 

» 

c 

1 D|B | 

c 

| D | B | 

c 

1 

1 D J 


1 

1 1 


1 1 1 


1 1 1 


1 1 

| BTAM (CICS/VS 1.3) 

1 1 


1 II 


1 1 1 


1 1 

^ BSC 3270/L3270 

10•06|0 

.055(0.20|0.06|0 

.03 

|0.20|0.06(0 

.03 

|0.20| 

| Start—Stop 

|0.06|0 

.04010.17|0.06|0 

.02 

|0.1710.0610 

.02 

|0.17| 

j Point—to—point 

|0.35| 

0 

| 0 10 .30 | 

0 

| 0 |0.30| 

0 

1 0 1 


1 1 


1 1 i 


1 1 1 


1 1 

| BTAM (CICS/VS 1.4) 

I 1 


1 1 1 


1 1 1 


1 1 

| BSC 3270/L3270 

|0.12| 

0 

| 0.2410.121 

0 

|0.24|0.12| 

0 

|0.24| 

| Start—Stop 

|0.12| 

0 

|0.2 |0.12| 

0 

|0.20|0.12| 

0 

|0.20| 

j Point—to—point 

|0.35| 

1 1 

0 

1 0 J0.3 | 

1 1 I 

0 

| 0 (0.3 | 

1 1 1 

0 

t o | 
1 1 

| VTAM 

1 1 

1 1 


1 1 1 

1 1 1 


1 1 1 

1 1 1 


I V 

1 1 

| All devices 

k . . . ... 

1 0 | 

0 

I 0 | 0 1 

0 

1 0 | 0 I 

0 

1 0 1 
_i 


Table 3. Values for Line and Terminal Constants (B, C, and D) in 
milliseconds 

Notes : 

• Values for local 3270 networks are not currently available. Remote 
3270 figures should be used as a first approximation. 

• In practice, the variation of CICS/VS pathlength with network size 
is a very complex function of network size and type, TP access 
method, transaction rate and CICS/VS functions used. The values 
given will only give an order of magnitude value. 

• For very high message rates (>5/second) , the DOS/VS *C" values for 
CICS/VS 1.3 should be halved. For very low message rates 

(<0.5/second) , the OS/VS *C* values for CICS/VS 1.3 should be 
doubled. In practice, in both cases the transition from one "C" 
value to the other will be a smooth function of the message rate. 

• The DOS/VS values for CICS/VS 1.3 assume that the ICVTSD value is 
set to zero. A higher value will decrease the pathlength. At one 
second it should be similar to the CICS/VS 1.3 values for OS/VS. 

• The CICS/VS 1.4 figures show significant improvements for large 
multipoint networks. The improvement shows where there are more 
than 3 terminals per line. 
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TABLE 4. 


I-| 

| System/370 Processor Relative Power | 

| Model Factor | 


115 

50 

115-2 

85 

125 

85 

125-2 

120 

135 

185 

138 

230 

145 

350 

148 

430 

155-2 

600 

158 

860 

158-3 

950 

Hypothetical standard 
processor (see Note 3) 

1000 

3031 

1100 

168 

2100 

168-3 

2400 

3032 

2500 

3033 

4400 


Table 4. Approximate Relative Power Factors for Dedicated 
ClCS/VS Systems 


Notes : 

1. The values for the 3031 f 3032 , and 3033 have not been measured in a 
dedicated CICS/VS environment and only represent a very rough 
estimate for guidance only. Possible errors are (plus or minus) 
10 *. 

2. The figures given do not account for the impact of the microcode 
assist feature that is available on some processors and they will 
generally give a pessimistic result if the assist feature is used. 

A conservative estimate of the improvements is 10* in a dedicated 
CICS/VS environment. 

3. The hypothetical standard processor's relative processing power is 

1000. 

TABLE 5. 


i- 

| DOS/VS | 

-1 

OS/VS1 | OS/VS2 (MVS) | 

| CICS/VS 1.3 


1 

! 

1 V 

1 0.2 | 

0.2 | 

0.2 | 

1 x 

1 i.o | 

3.0 | 

5.4 | 

1 Y 

| 0.04 | 

0.04 | 

0.04 | 

1 z 

| CICS/VS 1.4 

| 0.07 | 

1 1 

1 1 

0.07 | 

1 

1 

0.07 | 

1 v 

1 0.2 | 

0.2 | 

0.2 | 

1 x 

1 1-0 | 

3.0 | 

5.4 | 

1 Y 

I 0.05 | 

0.05 | 

0.05 | 

1 z 

i 

1 0.2 | 

1 1 

0.2 | 

1 

0.2 | 

_i 


Table 5. CICS/VS Background Timings (in milliseconds) 
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Chapter 8.3. Virtual Storage 


In order to run the system efficiently, the system programmer needs to 
be able to estimate the virtual storage requirements. If insufficient 
virtual storage is allocated, the system will either not function or it 
will suffer degraded performance. If the virtual storage requirements 
are grossly overestimated, performance will also suffer. Fortunately, 
the estimation does not need to be too accurate. In general, the system 
programmer needs to be able to calculate the virtual storage 
requirements to an accuracy of about 25% of the real storage size. For 
example, if a CICS/DOS/VS system with VSAM and VTAM were running on a 
370/145 with 512K bytes of real storage, the virtual storage allocated 
would probably be approximately 2.5 megabytes, and the system programmer 
should be able to gauge his virtual storage requirements to the nearest 
128K bytes. Calculation in greater detail is wasted effort. 

Virtual storage requirements are divided into four areas. These are: 

• Non—CICS/VS requirements, which include the operating system, major 
access methods, and work areas. These requirements exclude 
anything contained in the CICS/VS partition or region. 

• Static CICS/VS areas, that is, requirements for CICS/VS modules and 
tables storage which do not depend on the transaction rate. 

• Dynamic requirements of CICS/VS and major access methods which vary 
with the amount of traffic in the system. 

• Application programs and data area space. 

Figures 8.3—1, and 8.3—2 at the end of this chapter show the general 
disposition of storage for CICS/DOS/VS and CICS/OS/VS. Figure 8.3—3 
provides data that may be used to calculate the OSCOR size in 
CICS/OS/VS. 

These virtual storage areas are discussed in the sections which 
follow. 

In addition, the chapter also contains three tables of data: 

• Table 6 provides information on operating system requirements. 

• Table 7 gives the sizes of the CICS/VS modules and tables. 

• Table 8 gives the sizes of infrequently used CICS/VS modules. 


OPERATING SYSTEM AND MAJOR ACCESS METHOD REQUIREMENTS 


The appropriate manuals give detailed virtual storage estimates for the 
operating systems and major access methods. These estimates should be 
used when making detailed calculations, especially when other programs 
besides CICS/VS are being run on the same machine. 

The figures given below are for illustrative purposes only and 
represent only a small number of possible cases. Variations on these 
numbers will occur, depending on the options selected. 
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DOS/VS 

Minimum system + B TAM/I SAM/DAM 200K bytes 
System with BTAM/VSAM 512K bytes 

System with VTAM/ISAM/DAM 120 OK bytes 

System with VTAM/VSAM/ISAM 1600K bytes 

Table 6* Operating system requirements including major access methods 
but excluding CICS/VS 


OS/VS1 

1.0M bytes 
1*5M bytes 
2.2M bytes 
3.0M bytes 


STATIC CICS/VS AREA REQUIREMENTS 


The virtual storage requirements given below are for CICS/VS nucleus 
modules and control blocks, which are normally resident in virtual 
storage and are included in the CICS/VS partition or region. For 
CICS/DOS/VS, certain non—CICS/VS areas are included in the partition 
because they are included in CICS/VS modules or tables. For OS/VS and 
DOS/VS, CICS/VS gives part of its region*s storage back to the operating 
system. This is known as OSCOR (for OS/VS) and is discussed below. 

This section does not discuss areas which are allocated in the 
CICS/VS dynamic storage area. 


CICS/VS MODULES 


The storage requirements can be obtained by summing the sizes of all the 
CICS/VS modules to be used. An allowance should be made for the 
packaging of the various modules, and hence some module sizes should be 
rounded up to the next page boundary. A knowledge of the nucleus load 
table layout is required. Alternatively, the size of each module or 
table can be rounded up to the next page boundary. In addition to 
CICS/VS requirements, the sizes of all resident application programs, 
control blocks and maps should be added. 

Table 7 (below) gives the sizes of CICS/VS modules, with variations 
for major options for both DOS/VS and OS/VS. 
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1- 

I CICS/VS Module 

1 DOS/VS 

I OS/VS 

i 

1 

| DFHCSA 

including default 512 

i 

i 




bytes user area 

| 4258 

1 

| 4624 


| DFHKCP 

(Task Control) 

| 7000 

• 

| 8160 


| DFHSPP 

(Sync Point) 

| 2720 

1 

| 2744 


| DFHSCP 

(Storage Control) 

| 6400 

| 6944 



Recovery=Yes 

| +3138 

| 3160 



Add size in bytes of the DSA in K bytes 

1 

1 

1 x 2 


| DFHPCP 

(Program Control) 

1 




Assembler only 

| 3000 

| 3700 



Assembler, PL/I, and RPG II (DOS/VS) 

| 4328 

| 4200 



Assembler , COBOL/ and RPG II (DOS/VS) 

J 5466 

| 6100 



All support 

| 5740 

i 

| 6568 


| DFHTCP 

(Terminal Control non—VTAM) 

1 

i 




BASE 

| 3200 

| 3600 



Sequential support 

| +1000 

| +700 



Console support 

| — 

1 n/a 



TCAM support 

1 n/a 

1 

| +3000 



Automatic initiation 

1 +140 

| +160 



BTAM support 

i 




Start/Stop non switched 

1 o 

1 0 



Plus Autopoll and Wraplist - 

| +650 

| +270 



Switched 

| +450 

| +430 



Translate tables 2740/2741E/Sys/7 

| +520 

| +520 



Correspondence 2741c 

| +290 

| +290 



Text Mode Correspondence 2741CM 

| +260 

| +260 



Text Mode EBCDIC 2741EM 

1 

i 




BTAM BSC — any device 

1 

| +2080 

| +520 



Non switched 

| +840 

| +800 



Switched 

| +1300 

| +1200 



Translate table ASCII 

| +520 

■ 

| +520 



1050 Translate Table 

| +520 

l +520 



Switched support 

| +560 

| +480 



Non switched 

| +580 

i 

| +550 



2260 Base 

1 

| +720 

| +570 



Local 

| +590 

| +590 



Remote 

| +920 

i 

| +850 



2740 Switched 

1 

| +580 

| +510 



Non switched 

| +590 

| +540 



Model 2 with Buffer Receive 

| +320 

■ 

| +320 



2741 Switched 

1 

| +500 

| +460 



Non switched 

| +320 

| +300 



Other features 

| +360 

■ <5- 

| +460 



2770 Switched 

1 

| +300 

| +300 


i_ 

Non switched 

| +340 

| +340 

-j 


Table 7. (Part 1 of 4) CICS/VS Module Sizes in Bytes 
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I 

I 

I 

I 

I 


r 

1 

CICS/VS Module 

| DOS/VS 

1 0S/VS 

-i 

i 

r~ 

2780 Switched 

| +300 

1 

| +300 



Non switched 

1 +360 

I +360 

i 



2980 Common 

| +2400 

1 

| +2400 



Model 1 

I +330 

| +330 



Model 2 

| +330 

| +330 



Model 4 

| +350 

| +350 



tablfix=yes 

| +3850 

| +3850 

i 



3270 Support (BTAM) 

| +1100 

1 

| +900 

i 



Local 

| +1730 

| +1730 



Remote 

| +3300 

| +3300 



Upper Case Translation EBCDIC 

| +320 

| +320 



Upper Case Translation ASCII 

| +280 

1 

| +280 

1 



3270 Compatibility — Basic 

1 

| +4000 

| +4000 



Additional features 

| +220 

■ 

| +220 

i 



3735 Dial 

i 

l 

I 

| +1430 

i 



3740 

| +350 

1 

| +350 



Switched 

| +1450 

| +1450 



Leased 

| +1200 

| +1200 



3780 Switched 

1 

| +300 

| +300 



Leased 

l +340 

| +340 

1 



7770 

1 

1 

1 

1 



CONVTAB = ABB 

| +330 

| +330 



CONVTAB = ABC 

| +280 

| +280 

1 



System/7 

1 

| +200 

| +200 



Switched 

l +1000 

| +1000 



Non Switched 

| +860 

1 

| +860 

■ 



TLX 

| +1270 

| +1270 



TWX 

| +940 

| 

| +940 

| 



DFHZCP (BTAM/VTAM Terminal Control) 

1 

l 

1 

1 



DFHZCP working set (BTAM only) 

| 1150 

I 1150 



working set (3270 only) 

| 4384 

| 4000 



working set (all support) 

| 5180 

| 4784 



DFHZCA working set (VTAM only) 

| 4256 

| 3648 



DFHZCB working set (VTAM 3270) 

I 10900 

| 10900 



working set (all support) 

| 13800 

| 13976 



DFHZCX nonr-working set (BTAM only) 

| 916 

| 916 



non—working set (VTAM 3270 only) 

| 2280 

| 2280 



non—working set (all support) 

| 5000 

| 6864 



DFHZCY non—working set (VTAM only) 

| 8264 

| 9560 



DFHZCZ non-working set (VTAM 3270) 

| 4616 

| 4400 



non—working set (VTAM all) 

| 6424 

1 

| 6112 

1 



DFHICP (Interval Control) 

| 3212 

■ 

| 3040 


L 

DFHSDAM (DAM logic module) 

| 1900 

| NA 

_i 


Table 7. (Part 2 of 4) CICS/VS Module Sizes in Bytes 
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1- 

1 

CICS/VS Module 

1 DOS/VS 

I 0S/VS 

i 

r~ 

DPHSRP 

(System Recovery) 

| 2044 

| 4351 

“i 


DFHFCP 

pile Control) — DOS/VS only 






VSAM 

| 5452 

t NA 




+ automatic journaling 

| 6980 

| NA 




ISAM+DAM 

| 5808 

| NA 




+ automatic journaling 

| 6876 

| NA 




DAM*VSAM 

| 7344 

| NA 




+ automatic journaling 

| 8872 

| NA 




VSAM+ISAM 

1 8156 

| NA 




+ automatic journaling 

| 9764 

| NA 




VSAM+ISAM+DAM 

| 9168 

| NA 




+ automatic journaling 

| 10816 

| NA 




ISAM 

| 3832 

| NA 




+ automatic journaling 

| 4784 

| NA 




DAM 

| 4820 

| NA 




+ automatic journaling 

| 5764 

| NA 




indirect access, input, and output 






segmenting, add 

| +1700 

| NA 



DPHFCP 

— OS/VS only 

| NA 





Common 

| NA 





VSAM Common 

| NA 





VSAM non—ICIP 

| NA 





VSAM ICIP 

| NA 

| +2048 




BDAM Support 

| NA 





ISAM Support 

| NA 





Automatic Journaling 

| NA 

| +840 




Maximum Size 

| NA 

| 11064 



DFHFCD 

(ISAM/BDAM only) 






Common 

| NA 

| — 




BDAM 

| NA 

I — 




ISAM 

| NA 

1 — 




Maximum Size 

| NA 

| 3832 



DFHTDP 

(Transient Data) 






Base + EXTRAPARTITION 

| 630 

| 504 




plus INTRAPARTITION 

| 3000 

| 3800 




plus Recovery 

| 5066 

| 5512 



DFHTSP 

(Temporary Storage) 






Base (AUX=NO) 

| 2702 

| 2856 




AUX—YES 

| 4928 

| 5200 




^ AUX=REC 

| 7178 

| 7280 



DFHTRP 

(Trace Control) 






ATJX=YES 

| 8692 

| 7768 




AUX=NO 

| 2416 

| 2552 



DFHDCP 

(Dump Control) DISK (approx.) 

| 14000 

| 14000 


L 


TAPE 

| 35932 

| 35848 



Table 7. (Part 3 of 4) CICS/VS Module Sizes in Bytes 
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| CICS/VS Module 


| DOS/VS | OS/VS | 


DFHJCP 

(Journal Control) 

| 3756 

1 

1 

1 

4008 

DFHEIP 

(EXEC Interface Program) 

Base module DFHEIP 

1 

1 

| 4500 

1 

1 

1 

3592 


Other modules (all support) 

| 6500 

1 

1 

a 

8000 

DFHDIP 

(Batch Data Interchange program) 

| 3344 

1 

1 

1 

I 

3416 

DFHISP 

(Intersystem Communication program) 

| 1034 

1 

1 

1 

l 

728 

DFHMIR 

(ISC Mirror program) 

| 692 

1 

1 

1 

1 

712 


Table 7. (Part 4 of 4) CICS/VS Module Sizes in bytes. 


BASIC MAPPING SUPPORT 

The following modules can be generated: 

DFHMCP Control Program 
DFHPBP Page Build 
DFHIIP Non 3270 
DFHTPP Terminal Page Program 
DFHM32 3270 Mapping 
DFHDSB Data Stream Builder 
DFHRLR Route list resolution 
DFHTPQ Terminal Page Clean up 
DFHTPR Terminal Page Retrieval 
DFHTPS Terminal Page Scheduling 
DFHFIP Faster 2260 
DFHF2P Faster 2260 
DFHBMSMM Pre-VS module 

Total virtual storage space requirements (assuming that the modules 
are resident and packed end-to-end) are given for a few different sets 
of BMS processing options. 


Minimum 3270 Mapping 

Minimum 3270 mapping + sequential devices 
Minimum 3600 mapping + sequential devices 
Default 3270 mapping 

Default 3270, 3600, 2740, 2770 mapping 

Default 3270, 3600, 2740, 2770 mapping + Paging and Routing 


6K bytes 
16K bytes 
14K bytes 
16K bytes 
23K bytes 
3OK bytes 


These numbers will allow the user to gain an approximation to his 
actual sizes. This should be ample information to allow a calculation 
of sufficient accuracy to be made for the virtual storage requirements. 


The remaining CICS/VS programs are defined in the DFHPPT and can 
either be resident or non-resident in main storage. If they are 
resident, virtual storage should be allocated. If non-resident, space 
need not be allocated for all programs because they will not all be used 
concurrently. However, for reasons of efficiency, it is suggested that 
those programs used during on-line operation (that is, not at 
initialization or during shutdown) should be allocated space. The sizes 
given are maximums and are, for the most part, the same for DOS/VS and 
OS/VS. Where they differ, the larger is given. 
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PROGRAM NAME 

SIZE 

PROGRAM NAME 

SIZE 

DFBACP 

5568 

DFHPEP 

48 

DFHAKP 

704 

DFHRD1 

1906 

DFHAQP 

240 

DFHRD2 

744 

DFHATP 

3656 

DFHRKB 

116 

DFHBMSMM 

1904 

DFHRUP 

7816 

DFHCPY 

296 

DFHSFP 

344 

DFHCWTO 

1656 

DFHSNP 

250 

DFHDBP (for DL/I) 

7890 

DFHSTKC 

6192 

DFHEXI 

176 

DFHSTLK 

2212 

DFHFEP 

4420 

DFHSTP 

3954 

dfbjcbsp 

424 

DFHSTPD 

2176 

DFHJCC 

308 

DFHSTSP 

6528 

DFHJCEOV 

460 

DFHSTTD 

3164 

DFHJCI 

1048 

DFHSTTR 

5392 

DFHJCIOE 

612 

DFHTACP 

5568 

DFBJCJFP 

920 

DFHTAJP 

696 

DFHJCKOJ 

660 

DFHTBP 

10794 

DFHJCO 

2700 

DFHTDRP 

1316 

DFHJCOCP 

2000 

DFHTEP 

40 

DFHJCSDJ 

464 

DFHTEPT 

— 

DFHMSP 

10908 

DFHTPQ 

2484 

DFHMTPA 

10336 

DFHTPR 

11496 

DFHMTPB 

10760 

DFHTPS 

40 

DFHMTPC 

10920 

DFHTSRP 

3280 

DFHMTPD 

9312 

DFHUAKP 

— 

DFHMTPE 

9216 

DFHWT1 

2822 

DFHMTPF 

10664 

DFHWT2 

1764 

DFHMTPG 

9784 

DFHZNAC" 

10408 

DFHOCP 

3648 

DFHZNEP 

56 

DFHPLP 

152 

DFHZRLG 

360 

DFHP3270 

1104 

DFHZRSP 

556 

DFHPRK 

440 




Table 8, Sizes of Infrequently Used CICS/VS Modules 


CICS/VS TABLE SIZES 


The sizes of CICS/VS tables and static control blocks depend on the 
number of entries in the various tables. The virtual storage 
requirements__should include space for all entries, together with an 
"~a±lowance for expansion as more devices, data sets or programs are added 
to the system. Tables which are used during system initialization and 
then overwritten are not included in these estimates. 

The sizes of the various tables given below should be rounded up as 
necessary to the next page size unless the tables are packed close to 
other modules or tables. The nucleus load table in use (default or 
user—supplied) should be used to assist in the mapping of these tables. 
In all the tables below, *E“ is the number of entries, *C* is the table 
header or constant value, and *R" is the number of remote entries (for 
use with connected systems) . 


PROGRAM CONTROL (DFHPCT) 

Size=C + 64E + 32R 

For the sequential scan routine, C=160 bytes, and for the index scan 
C=176 bytes. In addition, when the INDEX option is used, an additional 
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106 bytes per identifier should be allowed for the index table. E 
should include the CICS/VS service programs, a list Of which is given in 
Appendix A under “Program Control Table*. 


PROCESSING PROGRAM TABLE (DFHPPT) 

Size=C + 40E + 52CE for 0S/VS 

Size-C + 56E + 68CE for DOS/VS 

where: *C“ is 160 bytes. If PAGENXD=YES is used, “C*=176 bytes and an 
additional 10 bytes per entry is required for the index table. 

“E“ is the number of assembler, PL/I, and RPG II entries. “CE“ is the 
number of COBOL entries. 

DESTINATION CONTROL (DFHDCT) 

Size=140 + (El ♦ E2 ♦ ...E n ) + AM 

where “E n * are the sizes df each entry (see the table below) and “AM* is 
the total number of bytes required for access methods when using 
CICS/DOS/VS. The sizes of the DOS/VS access method modules can be found 
in the DOS/VS System Generation manual for the appropriate release. If 
PAGENXD=YES is used, add 6 bytes for each INTRA or EXTRA entry. 


Entry Sizes 

84 bytes 
16 bytes 
16 bytes 
24 bytes 

To the above, add the following as appropriate for TYPE=SDSCI (1 per 
physical data set): 



DOS/VS 

OS/VS 

Automatic OPEN, BUFNP=n 

nxB 

Note 1 

Printer 

60 

96 

Disk — Fixed input 

140 

96 

— Fixed output 

172 

96 

— Variable output 

180 

96 

Tape — Standard labels 

16 

96 

— Fixed records 

100 

96 

— Variable records 

112 

96 


Note 1 : B^buffer length for DOS/VS. For OS/VS, although the storage is 
not part of the table, it must be given back to OS/VS as part of OSCOR. 

TEMPORARY STORAGE (DFHTSUT) 

a) DFHTSUT Size =32+32E 

b) Temporary storage data set control information size — 272 + M bytes 
where M- the number of control intervals in the temporary storage 
data set. 

c) Two buffers (each to accommodate the VSAM control interval size). 


TYPE^INTRA 
TYPE=EXTRA 
TYPE-INDIRECT add 
TYPE-REMOTE add 
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Notes : 

1. Minimum table sizes or optimum ordering of entries is assumed. 

2. CICS/VS user data areas are the larger of 256 bytes or minimum 
values. These include TIOAs and FIOAs. These minimum values are 
allowed for in the BASE sizes. 

3. Where values are not tabulated , it is recommended that virtual 
storage sizes are substituted for all frequently used functions. 
Infrequently used functions (for example, master terminal support 
for CSMT) should be ignored. 

4. It is assumed that CICS/VS modules only contain those functions 
that are frequently used. Hence, if the actual system contains 
functions that are used infrequently (for example, Terminal Control 
with sequential disk support) the sizes of these functions obtained 
from the virtual storage tables in Chapter 8.3 should be added to 
the reference set size. 
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1— ---1 

I Function 

Static Reference Set | 

i- 

| Dynamic Reference Set 

1 

i CICS/DOS/VS 

CICS/VS 

|OTHER 

TOTAL | 

| CICS/VS 

(OTHER 

|TOTAL 

-i 

1 

1 

IBASE functions 


! 

i 


i 

l 

i 


1 

|BTAM 3270 BSC 

40 

1 

110-14 

1 

50-54 | 

1 8 

1 

1 o 

i 

i 

8 

1 

1 

IBTAM start/stop 

40 

| 10 

50 | 

1 8 

1 0 

i 

8 


IBTAM 3270 local 

40 

1 B 

48 | 

1 B 

1 o 

i 

8 

1 

I VTAM 3270 local/BSC 

52 

1 See 

1 

| 10 

I See 

i 


l 

(VTAM SNA 


|Tables 

1 

1 10 

|Tables| 


1 



| 9810 

1 


| 9810 

i 


1 

1 Additional functions 


i 




i 


1 

1 (to be added to 


i 



i 

i 


1 

IBASE values) 


i 

I 

1 


i 

i 


1 

1 

|BMS 


i 

1 

1 


i 

i 

i 

i 


1 

1 

| — minimum 3270 

+8 

| NA 

+8 | 

| +4-6 

| NA 

i 

4-6 

1 

| — average 3270 

+12 

| NA 

+12 | 

| +4-6 

| NA 

i 

4-6 

1 

| - PAGING/ROUTING 

10+Aux. 

| See Auxiliary Temporary Storage 

1 


TS. 

i j i 

it* 


i 

i 


1 

I Command level 

+10 

i 

| NA 

I 

+ 10 1 

1 +2 

i 

i 

i 

i 

+2 

1 

1 

jinterface 


i 

1 


! 

i 


1 

|File control 


i 

i 

1 

i 


1 

1 

i 

i 


1 

1 

| - VSAM 

+10 

| add 

VSAM | 

| NA 

| NA 

i 

NA 

1 



| VSAM 

+10 | 


i 

i 


1 

| - BDAM/ISAM 

+8 

1 +6 

14 | 

| NA 

| NA 

i 

NA 

1 

| - VSAM/ISAM/ 

+ 16 

1 6 + 

22+ | 

| NA 

| NA 

i 

NA 

1 

| BDAM 


| VSAM 

VSAM | 


i 

i 


1 

|Per active file 


i 

1 


i 

i 


1 

| - VSAM 

+ 0.5 

1 6 

6.5 | 

i i 

|CISIZEI 

l+CISIZE 

| - ISAM 

+1 

| 0 

1 1 

1 1 

1 o 

i 

1 

1 

| - BDAM 

+0.5 

1 o 

i 

0.5 | 

1 1 

1 o 

i 

1 

1 

| Journal control 

+6 

1 

| NA 

1 

+6 | 

1 +2 

1 

| NA 

1 

i 

+2 

1 

1 

| (assumed buffer less 


i 

t 


i 

i 


1 

jthan 2K bytes) 


i 

i 

i 

i 


i 

i 

i 


1 

(Macro level 


i 

i 

1 

i 


i 

i 

i 

i 


1 

1 

| interface 

+2 

| NA 

+2 | 

1 o 

| NA 

i 

0 

1 

| (PL/I or COBOL) 


i 

■ 

i 


i 

i 

i 


1 

■ 

jTemporary storage 


1 

i 

i 

i 


i 

i 

i 

i 


1 

1 

| Auxiliary 

6 

| VSAM 

6+VSAM| 

1 o 

(CISIZEI 

CISIZEI 

1 Main 

4 

1 o 

4 I 

| —Main storage 

in use—| 

| Terminal control 


i 

i 

i 

i 

i 

i 

i 

i 

i 


1 

1 

| — BTAM per line 

0.12 


i 

1 o 

1 o 

i 

0 

1 

j — BTAM per device 

0.20 

| — 

i 

1 o 

1 

i 

0 

1 

| - VTAM per LU 

0.35 

| See 

i 

i o 

1 

i 


1 



|Tables 

i 


1 

i 


1 



| 9610 

l 

i 

■ 


1 

\ 


1 

| Transient data 


I 

1 

1 

1 


1 

1 

i 

i 


1 

l 

j — extrapartition 

2 

1 o 

2 I 

1 o 

1 o 

i 

0 

1 

| + intrapartition 

6 

1 o 

6 I 

1 o 

1 o 

i 

0 

1 

| BDAM 


1 

1 


1 

i 


1 

| + intrapartition 

6-8 

| VSAM 

— 1 

1 — 

|CISIZEI 

CISIZE 

1 

| VSAM 

i___ 


1 +6 

1 


i 

i 


1 

-1 


Figure 8.4—1. CICS/DOS/VS Reference Set Sizes in K Bytes 
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I 

I 

I 

I 

i 

i 


|Function 

| - .-. ... - - ..- 

i--- 

(Static Reference 

Set 

i 

-r 

I 

Dynamic Reference Set 

i 

i cics/os/vs 

i 

ICICS/VS 

|OTHER 

|TOTAL 

i 

i 

1 

CICS/VS 

OTHER 

(TOTAL 

i 

i 

i 

I Base functions 

• 

1 

1 

i 

i 

i 

i 

i 


i 

1 

1 




“i 

i 

i 

1 

jBTAM 3270 BSC 

1 

| 78 
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| 14 

i 

i 

92 

i 

1 

1 

6 

2 

1 8 

i 

i 

|BTAM start/stop 

( 74 

1 12 

i 

86 

i 

1 

6 

2 

1 B 

» 

JBTAM 3270 local 
| 

| 74 

1 B 

■ 

i 

i 

82 

i 

i 

1 

a 

6 

2 

1 B 

i 

JVTAM 3270 local/BSC 

1 

| 68 

i 

| See 

i 

i 


i 

i 

1 

1 

6 

See 


i 

i 

| VTAM SNA 

1 64 

(Tables 

i 



l 

6 

Tables 


i 

1 

i 

1 9510 

i 


i 

1 

1 


9810 


i 

i 

1 1 
(Additional functions 1 

1 

1 

i 

i 


i 

i 

1 

1 




1 

| (to be added to 

i 

1 

i 


i 

1 




i 

|BASE values) 

i 

i 

1 

| 

i 

1 


i 

I 

1 

I 




i 

■ 

|BMS 

1 

i 

1 

1 

1 

i 


i 

i 

1 

1 




I 

i 

j — minimum 3270 

1 +8 

| NA 

i 

+ 8 

i 

1 

+4—6 

NA 

| +4-6 

i 

| — average 3270 

| +12 

| NA 

i 

+12 


1 

+4-6 

NA 

| +4-6 

i 

| - PAGING/ROUTING 

| +10+ 

j See 

i 

♦ 10 + 

i 

1 

See Auxiliary Temporary | 


j Aux TS 

(Aux TS|Aux TS| 

Ilk 

1 

1 

Storage 

1 


i 

i 

| Command level 

| +10 

1 

| NA 

i 

+10 

i 

i 

1 

1 

+2 

NA 

1 +2 

i 

i 

jinterface 

1 

i 

i 


i 

1 




i 

i 

(File control 

1 

1 

• 

i 


i 

i 

1 

1 




i 

i 

| - VSAM 

1 +8 

| VSAM 

i 


i 

1 

0 

0 

1 o 

i 

| - BDAM/ISAM 

| +12 

| BDAM 

i 


i 

1 

0 

0 

| 0 

i 


1 

| /ISAM| 


i 

1 




i 

| - VSAM/ISAM/ 

| +14 

| VSAM 

i 


i 

1 

0 

0 

1 o 

i 

| BDAM 

1 

| /BDAM| 
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1 




i 


t 

| /ISAMI 



1 




i 

| per active file| 

1 

i 


i 

1 




i 

| - VSAM 
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1 o 

i 

6 

i 

|1+CISIZE 

0 

|1+CISIZE 
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| INDEX+l 

1 o 

i 

INDEX| 

|1+BLKSIZE 

0 

|1+BLKSZE 


l 

1 

i 

+1 

i 

i 



i 

i 

| - BDAM 

1 +1 

1 o 

i 

+1 

i 

(1+BLKSIZE 

0 

|1+BLKSZE 

1 I 

|Journal control 
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1 ♦6 
• 

1 

1 o 

1 

i 

+6 

i 

i 

i 

i 

i 

+2 

0 

l 
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| 

I 

1 

i 

| Macro level (PL/I 5 
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1 

1 0 

I 

i 
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i 

0 

0 

1 
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i 

i 

j COBOL) interface 
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1 
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i 

i 



1 
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i 

i 
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Figure 8.4-2. part 1 of 2) CICS/OS/VS reference Set Sizes in Bytes 
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|Function 


|Static Reference Set | | Dynamic Reference Set 


CICS/DOS/VS ICICS/VS |OTHER |TOTAL 

r--1-1- 

Transient data | | | 

— extrapartition | 2 | 0 | 2 

I I I 

♦ intrapartition | 6 | BDAM | 6+ 

BDAM | | | BDAM 

+ intrapartition |6+CISIZE| VSAM+j 6+ 
VSAM | ICISIZE| VSAM 

I I I 


CICS/VS 


OTHER 


TOTAL 


Figure 8.4—2. (Part 2 of 2) CICS/OS/VS Reference Set Sizes in Bytes 


Note : The "OTHER" column refers to OS/VS1 components, but will be 
| approximately true for 0S/VS2. CICS/VS figures include basic OSCOR 
I requirements where appropriate (for example, VSAM control blocks in 
j OSCOR are included in the CICS/VS column) . 
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Chapter 8.5. Physical I/Os 


One of the important resources in a system is the disk I/O subsystem, 
which includes channels, control units and disk devices. To ensure that 
bottlenecks do not occur and that the reponse of the subsystem is as low 
as possible, it is essential to spread the load out evenly across the 
various devices. To do this, the system programmer must be aware of the 
load on the various disks. This can be related back to CICS/VS 
transactions if the number of physical I/Os (as distinct from logical 
I/Os) initiated by each CICS/VS function is known. 

Figures 8.5—1, 8.5—2, and 8.5—3 provide information on physical I/Os 
in relation to CICS/VS functions, and on the capabilities of disk 
devices. 

This chapter provides data that relates the number of physical I/Os 
to CICS/VS functions. For example, when a file control GET is issued to 
a VSAM KSDS file with three levels of index with the minimum buffer 
allocations, four physical I/Os will take place; three for index records 
and one for data. If the GET had been issued to a VSAM ESDS file, only 
one I/O would have taken place. If the two files had, for example, been 
placed on separate disks and if an equal number of logical I/Os had 
occurred for each file, there would be a 4si imbalance, probably 
resulting in poorer performance than necessary. 

Figure 8.5—1 gives average numbers of physical I/Os caused by CICS/VS 
functions. In some exceptional cases, there will be variations to these 
values. In general, these values apply to both DOS/VS and OS/VS 
systems. 
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CICS/VS functions 


Average number of 
physical I/Os 


t__ 

| DOS/VS 


File Control 


| 0S/VS 


BDAM PUT/GET 

GET (UPDATE) 
PUT (UPDATE) 


1 

1 

1 


1 

2 

1 


VSAM ESDS GET/PUT 

GET/PUT (UPDATE) 


1 

1 


1 

1 


KSDS with minimum buffer allocation 
If N is the number of index levels 
including the sequence set, then: 
GET 
PUT 

GET (UPDATE) 

If one additional buffer allocated, 
1+N can be reduced to N. 

If more than one additional buffer, 
number is between N and N-l 


1+N 

1+N 

1+N 


1+N 

1+N 

1+N 


ISAM (cylinder index in core) 

GET 

PUT 

GET (UPDATE) 

PUT (UPDATE) 

If cylinder index not in core, 
add 1 to the above values. 
Overflow records (GET) , 
where F is the position of the 
record from the start of the 
chain. 


1 

1 

1 

2 


1 

1 

1 

2 


1+F 


1+F 


Temporary Storage (auxiliary) 

GET/PUT/GETQ 

PUTQ 


1 

1 


1 

1 


Transient Data 


Intrapartition BDAM: | 

PUT to queue | 2 

PUT to empty queue | 5 

PUT to queue that fills the track | — 

GET first record from queue | 2 

GET subsequent record from queue | 1 

Intrapartition VSAM: | 

GET | 1 

GET first record from queue j 2 

PUT | 0 or 1 

Note that PUT only causes I/O when| 
the Cl is full or unless RECOVERY | 
is specified. | 


3 
8 
6 

4 
2 


1 

2 

0 or 1 


Figure 8.5-1. (Part 1 of 2) Average Number of Physical I/Os for 
CICS/VS Functions 
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| INTERSYSTEM COMMUNICATION (ISC) 


The support provided in CICS/VS Version 1, Release 4 allows only single- 
thread communication between CICS/VS systems* This will place 
limitations on the intersystem throughput. 

The components in the path between the systems will vary according to 
the installation. Communication could be through a "twin—tail* 3705 
providing, in effect, channel—to—channel communication, or it could be 
through a teleprocessing line. A simple calculation may be performed to 
estimate the limitation. The communication line system is taken as an 
example. 


There are five basic components for the communication line system. 
These are shown below. 



It is assumed that: 


• The load on the processor due to the ISC part is small, and that 
the total processor utilization is constant at, say, 75%. 

• The response time of the 3705 is constant at 25 milliseconds (any 
variation will be small compared with the overall response) . 

• The data transmitted on the line is large compared with the control 
characters and controls that are issued by VTAM. It is assumed 
that each transaction sends 200 bytes and receives 1000 bytes. 

It has been assumed that the operations are all of the "simple" type 
originating from the local processor and that a BID is never required. 

The following points are also assumed: 

• An average "operation* processor time of 5 milliseconds 

• A command-level interface overhead of 6% (for PL/1) — 0.3 
milliseconds 

• An ISC overhead of 19.4 milliseconds on the local system (for 
OS/VS1) 

• An ISC overhead of 19.1 milliseconds on the remote system (OS/VS1) 

The service times for the local processor is 19.4 + 0.3 = 19.7 
milliseconds, and 19.1 ♦ 5.0 = 24.1 milliseconds for the remote 
processor. 

The response times of the processors for the thread can then be 
calculated by the same method used earlier in this chapter. For a 
utilization of 75%, the local system response is: 


| 19.7 + 0.67 x 0.75 x 19.7 

| 1-0.75 

| =59.1 milliseconds 

| The remote system response is: 
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24.1 + 0>67 x 0 >75 x 24.1 
1-0.75 

=72.3 milliseconds 

For simplicity, it has been assumed that there is no I/O on the 
remote system. 

There are two passes through each 3705; hence the total 370 5 response 
is 4 x 25 or 100 milliseconds. 

For the communications line, the response time equals the service 
time because there is a single—thread operation. 

Assuming a rate of 4800 bytes per second (600 characters per second) , 
the total line time will be: 


1000 + 200 seconds 
600 

=2 seconds 

Hence, the total response is the stun of the followings 


The lines 2000 milliseconds 
The 3705s 100 milliseconds 
The local processor: 59.1 milliseconds 
The remote processor: 72.3 milliseconds 


2231 milliseconds 

The maximum possible throughput will be approximately 1/2.231 or 0.45 
transactions per seconds. It should be remembered that actual ISC 
responses will be longer if the actual inter-arrival time of the ISC 
requests is not constant. 

If a "twin—tail* 3705 had been used so that the communication line 
delay was eliminated, the ISC response (service time) would have been 
approximately 232 milliseconds, which would have allowed a maximum of 
over 4 requests per second. 
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Chapter 8 .7. Examples of the Estimation Process 


In order that the reader can see how the estimating techniques that have 
been described in previous chapters are to be used, a complete example 
is given in this chapter, which follows through each of the processes 
described in Chapters 8.2 through 8.6. The processes ares 

• Calculating the processor utilization 

• Calculating virtual storage requirements 

• Calculating real storage requirements 

• Calculating I/O device utilization 

• Estimating response times and maximum loading. 


SYSTEM DEFINITION 

Firstly, the system whose resources are to be estimated is defined, as 
follows s 

• System/370 model 125—2 with 512K bytes using DOS/VS 

• 60 terminals, comprising 50 remote 3277 displays and 10 local 3270 
displays 

• The remote devices are attached through 5 lines 

• --IGS/VS Version 1, Release 4 with BTAM, ISAM, and BDAM 

• ICV=5000 milliseconds 

• No batch 


APPLICATION DEFINITION 


Four main transactions are assumed: APPA, APPB, APPC, and APPD. All 
other transactions are used infrequently. Functions used by each 
transaction are given in Table 12, below. These are in addition to the 
BASE function. 
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■- 

| Functions 

| APPA 

l APPB 

| APPC 

| APPD 

"l 

|BDAM GET 

1 2 

i 

i 

i 

1 2 

i 

i i 


| GET (UPDATE) 

1 1 

i 

1 

i 


| PUT (UPDATE) 

1 1 

i 


i 

i 


| ISAM GET 


1 

1 1 

I 

1 2 

1 

i 


| GET (UPDATE) 


1 1 


1 2 


| PUT (UPDATE) 


1 1 
i 

i 

i 

1 2 
i 


jTransient Data 


1 

i 

I 

» 

I 

i 


| PUT 

i 

1 1 

1 1 



| GET 


i 

t 

i 

| 5 


| BMS 


i 

i 

I 

1 

i 


| TYPE=MAP 


1 1 

1 1 

1 1 


| TYPE=OUT , DATA=YES 


1 

i i 

i i 


| DATA=NO 


1 1 

i 

i 


| DATA=0NLY 


1 1 

i 

i 


| Subroutine Calls (LINK) 


i 

1 2 
| 

1 

1 1 

i 

i i 

l 


| Additional TC Output 


1 

| 1 

1 

1 

( 

1 

i 

1 


(Application Pathlengths 

| 1.5 

| 4.0 

| 3.0 

| 5.0 


| (in 1000s) 


1 

I 

i 

1 

| 


(Programming Language 

| Macro 

1 1 

| Command| Macro 

1 

| Command 



| assembler} COBOL 

■ i 

| assembler| COBOL 

■ i 


(Transaction Rate/Second 

| 0.3 

| 0.4 

| 0.3 

| 0.2 


| (System total = 1.2) 

1 

1 

1 

1 

1 

1 

1 

1 


i-. ..... .. 

1 

1 

1 

1 



Table 12# CICS/VS Functions for Transactions APPA, APPB, APPC, and APPD 
Notes : 

• BMS maps are composed of 20 fields: 10 data fields and 10 
preformatted fields. On input , an average of 5 fields are 
modified. 

• All message lengths are less than 256 bytes 

• The cylinder indexes of the ISAM files are in main storage 

• It is assumed that the transaction types are spread evenly over the 
different terminals 

• Assume that 1 in 5 transient data PUTS and GETs are the first 
record on a track 


CALCULATE PROCESSOR UTILIZATION 


The process has the following stages: 

1. Calculate the timings of each transaction on the hypothetical 
standard processor 
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2. Calculate the processor utilization for each transaction 

3. Calculate the background processor utilization 

4. Calculate the overall processor utilization 

These stages are discussed in the following sections. 


ESTIMATE THE TRANSACTION TIMINGS 


The base component ("a 0 “) is calculated first. Because there are two 
types of terminals, a weighted average is taken. 

The base component for the remote 3270s is 22 milliseconds; for local 
3270s, 10 milliseconds. 

Because there are 50 remote and 10 local terminals f the weighted 
average is given by: 

Base timing = 5 x 22 + 1 x 10 

6 

=20 milliseconds 

To this base timing is added the network component, which is given 

by: 


bL + cT + dT/L 

The total number of terminals is 60 and the number of lines is 6. 
(The local 3270s are treated as if they were on one line.) Hence, using 
the values of b, c, and d from Table 3 in Chapter 8.2: 


Network component =0.120x6+0x60+ (0.24) x 10 

= 3.120 milliseconds 

Note : For CICS/VS Version 1, Release 3, this value would have been 5.66 
milliseconds. 

Finally, *a x * values are calculated. Individual function times are 
taken from Table 2 (in Chapter 8.2) and are summed, as below. 
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APPA 


2 x BDAM GET 

at 

2.4 

each 

= 

4.8 

milliseconds 




1 X BDAM GET (UPDATE) 

at 

3.0 

each 

5 = 

3.0 

milliseconds 




1 X BDAM PUT (UPDATE) 

at 

2.8 

each 

= 

2.8 

milliseconds 




1 x transient data PUT 

at 

4.6 

each 

= 

4.6 

milliseconds 

(see Note 

i) 

Application code 





1.5 

milliseconds 



"a/ for APPA 




= 

16.2 

milliseconds 




APPB 










1 x ISAM GET 

at 

3.5 

each 


3.5 

milliseconds 




1 x ISAM PUT (UPDATE) 

at 

5.4 

each 

= 

5.4 

milliseconds 




1 x ISAM GET (UPDATE) 

at 

3.9 

each 

= 

3.9 

milliseconds 




1 x transient data PUT 

at 

4.6 

each 

= 

4.6 

milliseconds 

(see Note 

i) 

1 x BMS MAP 

at 

2.40 

each 

= 

2.4 

milliseconds 

(see 

Note 

3) 

1 x BMS OUT, DATA=NO 

at 

3.20 

each 

= 

3.2 

milliseconds 

(see 

Note 

3) 

1 X BMS OUT,DATA=ONLY 

at 

3.0 

each 

= 

3.0 

milliseconds 

(see 

Note 

3 

2 x LINK + RETURN 

at 

0.42 

each 

= 

0.82 milliseconds 




1 x TO output 

at 10.78 

each 

= 

10.78 milliseconds 

- 



Application code 




= 

4.0 

milliseconds 

(see 

Note 

5) 

Command level COBOL 




= 

7.357 

milliseconds 

(see Note 

4) 

•a,* for APPB 




= 

48.96 

milliseconds 




APPC 










2 x BDAM GET 

at 

2.4 

each 

sr 

4.8 

milliseconds 




2 x ISAM GET 

at 

3.5 

each 

s= 

7.0 

milliseconds 




1 x transient data PUT 

at 

4.6 

each 

S= 

4.6 

milliseconds 




1 x BMS OUT , DATA=YES 

at 

3.90 

each 

= 

3.9 

milliseconds 

(see 

Note 

3) 

1 X LINK + RETURN 

at 

0.42 

each 

= 

0.42 milliseconds 




Application code 




= 

3.0 

milliseconds 




m a x m for APPC 




= 

23.72 

milliseconds 




APPD 










2 X ISAM GET (UPDATE) 

at 

3.9 

each 


7.8 

milliseconds 




2 x ISAM PUT (UPDATE) 

at 

5.4 

each 

= 

10.8 

milliseconds 




5 x transient data (GET) at 

3.96 

each 

= 

19.8 

milliseconds 

(see 

Note 

2) 

1 X LINK + RETURN 

at 

0.42 

each 


0.42 milliseconds 




1 x BMS MAP at 2.4 each 



= 

2.4 

milliseconds 




1 x BMS OUT , DATA=YES at 3.9 

each 


= 

3.9 

milliseconds 




Application code 




= 

5.0 

milliseconds 




Command level COBOL 





5.89 

milliseconds 




■a/ for APPD 




= 

56.01 

milliseconds 





Notes: 


1. Average transient data PUT = 

4 x 3.5 + 1 x 9*0 =4.6 milliseconds 

5 

2. Average transient data GET = 

4 x 3.2 + 1 x 7.0 = 3.96 milliseconds 

5 

3. For the maps in use, pathlengths are with 10 data fields and 
10 format fields. 

TYPE=MAP = 2.4 milliseconds (only 5 fields are modified) 

TYPE=OUT,DATA=ONLY = 3.0 milliseconds 

,DATA=NO = 3.2 milliseconds 

,DATA=YES = 3.9 milliseconds 
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4. For COBOL, add 0.45 milliseconds plus 0.04 per call; for the 
command level interface, add instructions according to Table 2 
in Chapter 8.2. 

5. Loaded value according to the percentage of remote and local 
terminals and including the network component (0.5 x 96). 

Using Equation 2 in Chapter 8.2, (P = a 0 ♦ a* + bL + CT + (dT/L)) , 
the average values of the timings for each transaction are: 


I 

I 

I 

I 


APPA= 39.32 milliseconds 
APPB= 72.08 milliseconds 
APPC= 46.84 milliseconds 
APPD= 79.13 milliseconds 


CALCULATE THE TRANSACTION PROCESSOR UTILIZATION 


From Table 4 in chapter 8.2, a System/370 Model 125—2 has an average 
relative power factor of 120. 

The total time the processor is busy in each second for each 
transaction is the processor time ("p*) multiplied by the individual 
transaction rates. The values calculated are shown below. 


i- 

|Transaction|Transaction rate/sec.(Time (milliseconds) 

I-- 

I I I 


| APPA | 

0.3 

| 11.80 

| APPB | 

0.4 

| 28.83 

| APPC | 

0.3 

| 14.05 

l APPD | 

1 1 

| Total | 

0.2 

| 15.83 

1 

1.2 

| 70.51 


I 


The total time is divided by 120 (the relative power factor) to give a 
utilization of 0.588. 


CALCULATE THE BACKGROUND PROCESSOR UTILIZATION 


The ICV value is 5000 milliseconds (that is, 5 seconds) . The number of 
lines (*L“) is 6, and the number of terminals ("T") is 60. 

The pathlength per ICV scan is approximately: 

P= X ♦ YL + ZT + V (see Equation 4 in Chapter 8.2) 


In this case, V=0 (VTAM is not used) 
and for DOS/VS X=1.0 
Y=0.05 
Z=0 


Hence, P =1.3 milliseconds 
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The intercept value "A" is now calculated from the equations 
A— 100P/ (ICV x F) 

Because F (relative power factor) = 120 

A = (100 x 1.3) / (5000 x 120) = 0.0022 or 0.22% 

Note : For CICS/VS Version 1, Release 3, this value would have been 
0.9*. 

The overall processor utilization is the sum of the previous two 
stages. The value obtained is: 


| Utilization = 0.588 + 0.002 
| = 0.59 

Expressed as a percentage, this is 59* . 


ESTIMATE THE CICS/VS REFERENCE SET 


The static reference set is calculated first. The superset of all the 
functions used by the four frequently used transactions (APPA, APPB, 
APPC, and APPD) is the list given in Table 12. The BASE functions used 
are BTAM 3270 (local) and 3270 BSC (see Table 1 in Chapter 8.2) . 

From the "TOTAL" column in Figure 8.4—1 in Chapter 8.4, the following 
can be seen: 


fl- 

| Function |Static Reference 

| |Set (K bytes) 

i i 

-“1 

Set | 

V 1 

1 1 

| BASE (see Note) | 

57 


| BMS | 

• • 

8 


| Command level | 

| interface | 

i ■ 

10 


f 1 

| File control | 

| (BDAM/ISAM) | 

1 i 

14 


V I 

| Per file | 

| — 2xBDAM | 

| — 2xISAM | 

2 

2 


1 1 

| COBOL | 

i i 

2 


1 1 

| 6 BTAM lines | 

i i 

0.72 


1 I 

| 60 BTAM devices | 

i i 

12 


1 1 

| Transient data | 

i i 

6 


1 1 

| Total | 

| (rounded up) | 

L___ 

114K bytes 

--1 
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Notes : 

1. A combination for local and remote is not given in the table. The 
value was obtained by taking the 3270 BSC figure, adding the local 
3270 code size (from DFHTCP virtual storage sizes in Chapter 8.3) , 
and calculating the BTMOD size for local and BSC 3270s from the 
DOS/VS System Generation manual. Approximately 2K bytes has been 
added for the CICS/VS part, and IK bytes for BTMOD, making a total 
of 57K bytes for the BASE. 

2. The *per file" values were estimated from DFHFCT requirements, 
rounded up to the next page boundary. 

If we assume a DOS/VS supervisor size of 64K bytes for this example, 
this would give a total static size of 178K bytes. 

We can now calculate the dynamic requirement. 

The average transaction rate is 1.2 transactions per second, and the 
appropriate host processor response can be calculated to be 
approximately 1.6 seconds. The product of these two values is 
approximately 2.0. To preserve at least a 10:1 chance of not causing 
paging, we need approximately 2.0 x 3, or 6 times the DRS• 

Using Table 12 in this chapter and Figure 8.4—1, the DRS can be 
calculated to be approximately 16K bytes, that is, approximately 96K 
bytes (16 x 6) are needed. If a 4:1 chance is acceptable, we need 
approximately 64K bytes (that is, 2xCxRx DRS) • 

Taking the last value, we see that the total requirement is 242K 
bytes, which matches the available storage of 256K bytes. The larger 
value of 96K bytes estimated to be the storage necessary to give about a 
10:1 chance of not encountering a page fault requires 278K bytes. This 
implies that the system would run reasonably well with only an 
occasional page fault. 


ESTIMATING VIRTUAL STORAGE REQUIREMENTS 


The first step is to choose the approximate example given for operating 
system and access method requirements (Table 6 in Chapter 8.3) . 

From this we chose the minimum system with 200K bytes. 

We now calculate the CICS/VS requirements. 

Firstly, resident module sizes. The modules to be used and their 
sizes are taken from Table 7 in Chapter 8.3. These are (in K bytes) : 
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DFHCSA 4 
DFHKCP 7 
DFHSPP 2 
DFHSCP 6 
DFHPCP (COBOL & assembler) 5 
DFHTCP 

(Local & Remote 3270 8 Console Support) 12 
DFHZCP group 2 
DFHSDAM 2 
DFHFCP 6 
DFHTDP 3 
DFHEIP 11 
DFHTRP (Auxiliary) 9 
DFHDCP (Tape) 36 
BMS (Minimum 3270) 6 

Module Total 111K bytes 


Note s All modules have been rounded to the next K bytes for ease of 
calculation since we are only interested in an approximate figure for 
virtual storage. 


The next set of sizes belongs to CICS/VS programs residing in the 
PPT. We assume that all these programs will be made resident in virtual 
storage. 


The basic sets of modules are (in K bytes) s 


8 

80 
26 
6 
4 

Module Total 124K bytes 

It is now necessary to estimate the size of the CICS/VS tables. The 
major tables are: 


DFHJxx — Journaling 
DFHMTxx — Master Terminal 
DFHSTxx — Statistics 

DFHTAxx — Terminal Abnormal Condition Program 
DFHOCP — Dynamic Open/Close Program 


DFHPCT, DFHPPT, DFHFCT, DFHDCT, DFHTCT and DFHTRT 

For the purposes of this example, we will assume that, including 
required entries, the numbers of entries and sizes (rounded to the page 
size) are (in K bytes) : 


DFHPCT 

50 

entries 

4 

DFHPPT 

80 

entries (10 COBOL) 

6 

DFHFCT 

10 

files (5 BDAM, 5 ISAM) 

12 

DFHDCT 

16 

destinations 

6 

DFHTCT 

60 

terminal entries & BTMOD 

26 

DFHTRT 

500 

entries 

8 



Module Total 

62K bytes 

The next 

step 

is to estimate the size of 

the application programs and 


maps. It will be assumed that they are all resident in virtual storage 
and that the total size is 120K bytes. 

The final step is to calculate the dynamic storage area size. MXT 
(the limit on the number of simultaneous tasks) is assumed to be 10. 

For the most frequently used transactions (APPA, APPB, APPC and APPD) 
the maximum storage used is assumed to be 12K bytes for the purposes of 
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this example• Hence a DSA of 120K bytes would be adequate. In 
addition, an allowance of 16K bytes is made for the storage cushion, 
giving a total of 136K bytes. 

In summary we have (in K bytes) s 



System 

200 


Nucleus 

111 

1 

Other CICS/VS Modules 

124 


Tables 

62 


Applications 

120 


DSA 

136 

1 


753K bytes 


Since the cost of having too little virtual storage is far greater 
than having too much, the total size should be increased by about 10%, 
| as a contingency, to 820K bytes . 


ESTIMATE THE NUMBER OF PHYSICAL I/OS AND THE DEVICE SERVICE 
TIMES 


Here we use Figure 8.5.1 and 
transaction according to the 


APPA 

6.6 

I/Os 

APPB 

6.6 

I/Os 

APPC 

6.6 

I/Os 

APPD 

13.0 

I/Os 


calculate the number of I/Os for each 
functions invoked by each one. 

(Note : Each transient 
data PUT averages 2.6 I/Os 
for the environment of this example) 


Multiplying each of these by the transaction rates and summing them, we 
see that the total I/O rate is 9.2 per second. 


| For the purposes of this example, because 3.8 I/Os per second are to 
the transient data destinations, we assume that 8 I/Os per second go to 
a single disk and that the other 5.4 per second are spread over two 
further devices. The devices are 3340s with a capacity of 70M bytes. 

For the transient data device we make the assumption that the data 
sets only spread across 3 cylinders, giving an average seek time of only 
8 milliseconds, on the other two devices, we take the average seek time 
of 25 milliseconds. The rotation delay is 10.1 milliseconds in both 
cases. The average record length (for this example) is assumed to be 
512 bytes in all cases, so that the average transfer time is 0.5/885 
seconds, that is, approximately 0.45 milliseconds. 

The channel service time (*tsc*) is thus: 10.1 + 0.45 = 10.6 
| milliseconds. Since the total channel rate is 9.2 per second, the 
| channel utilization ("Uc") is: 


| 9.2 x 10.6 x 10-3 = 0.098 

| Using the equation: Channel wait = tsc x Uc/(1-Uc) 

| = 10.6 x 0.098 

I 0.902 

I =1.15 milliseconds. 
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Hence, for the transient data device, the service time is 10.6 + 1.15 
♦ 8.0 = 19.75 milliseconds. For the other devices, the service time is 
10.6 + 1.15 + 25.0 = 36.75 milliseconds. 


| ESTIMATING THE AVERAGE RESPONSE TIME 

An approximate value of the average response time for the system is now 
calculated using the simple method described in Chapter 8.6 

The average processor service time = Processor utilization/transaction 

rate per second 
= 0.59/1.2 
= 0.49 seconds. 

Hence the processor queue time "tqc" is given by: 

tqc = 0.67 x 0.49 x 0.59 

1-0.50 

= 0.47 seconds 

giving an average processor response time of 0.49 ♦ 0.47 = 0.96 seconds. 
The average disk queue time is calculated as follows: 

The average service time "tsd" = 

3.8 x 19.75 ♦ 5.4 x 36.75 
9.2 

= 29.728 milliseconds 
= 0.03 seconds 

The utilization is given by "tsd" x disk access rate/number of disks 

= 0.03 x 9.2/3 
= 0.092 

Since the average number of disk accesses per transaction is 9.2/1.2 
= 7.67 per transaction, the average disk service time for each 
transaction is: 

7.67 x 30.0 = 223.0 milliseconds 
= 0.223 seconds . 

Hence, "tqd" = 0.67 x 0.223 x (0.092/1-0.092) 

= 0.015 seconds 

so that the average disk response is 0.223 + 0.015 = 0.238 seconds. 

Hence, the average response in the processor is given by: 

tr = trc + trd 
= 0.96 + 0.238 

| = 1.20 seconds 
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| This calculation has assumed no page faults. 

| Taking the very approximate value of 25 milliseconds to resolve a 
| page fault, we can see that even if the system suffered 10 page faults 
| per second, the processor “q" times would be significantly increased 
| because only 750 milliseconds in each second would be available for 
| useful work, and the effective utilization would become approximately 
| 79%, making the queue time equal to: 


| 0.67 x (0.79/1—0.79) x 0.49 

| = 1.24 seconds , an increase of 0.73 seconds. 

| Adding the contribution to the response due to the page faults (0.25 
| seconds) , the overall response would become about 2.2 seconds , an 
| increase of about 1 second. 
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PROGRAM 

NAME 

DFHPPT TYPE 
=GROUP,FN= 

DFHSNT 

SIGNON 

DFHSTKC 

STANDARD 

DFHSTLK 

STANDARD 

DFHSTP 

STANDARD 

DFHSTPD 

STANDARD 

DFHSTSP 

AUTOSTAT 

DFHSTTD 

STANDARD 

DFHSTTR 

STANDARD 

DFHTACP 

STANDARD 

dfhtajp 

TIME 

DFHTBP 

RECOVERY 

DFHTDRP 

recovery 

DFHTEP 

STANDARD 

DFHTEPT 



DFHTLTxx 


| DFHTPQ MSWITCH 
| or BMS 


| DFHTPR MSWITCH 
| or BMS 


| DFHTPS MSWITCH 
| or BMS 


DFHTRNxx — 


DFHTSRP RECOVERY 


USAGE 


Sign—on table (only required if sign-on/sign—off 
function is desired) . 

Supervisor statistics program. 

ISC Link statistics program. 

System termination program linked to by DFHMTP. 

Program and dump statistics program linked to 
by DFHSTKC. 

Automatic statistics summarization control program. 

Data management statistics program linked to by 
DFHSTKC. 

File and terminal statistics program linked 
to by DFHSTKC. 

Terminal abnormal condition program. 

Time adjustment program that automatically adjusts 
the data and time of day maintained by CICS/VS 
to reflect the date and time of day maintained by 
the operating system. 

Transaction backout program. 

Transient data recovery program for recovery/restart. 

Terminal error program linked to by DFHTACP. 

This can be the dummy terminal error program 
provided during the generation of the control 
system operational group, a generated version of 
the sample terminal error program provided with 
CICS/VS, or a user—written terminal error program. 

Terminal error program table (only required if 
a generated version of the sample terminal error 
program provided with CICS/VS is used) . RES=YES 
should be specified in the PPT entry for DFHTEPT. 

An entry for each terminal list table generated 
by the user with the DFHTLT macro instruction. 

Basic mapping support program (only required 
if CICS/VS basic mapping support is being used). 

Basic mapping support program (only required if 
CICS/VS basic mapping support is being used) . 

Basic mapping support program (only required if 
CICS/VS basic mapping support is being used) . 

Nonresident data set control blocks as specified 
by the user in DCT. (Specify RELOAD=YES for each.) 

Temporary storage recovery program. 
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DFHUAKP — 

DFHWT1 ATP 
DFHWT2 

DFHXITxx — 

DFHXLTxx — 

DFHZNAC VTAM 
DFHZNEP VTAM 

DFHZRLG RESPLOG 
DFHZRSP RESEND 


User- 

specified 

name 


User Activity Keypoint Program linked to by 
DFHAKP. This can be a user-supplied program 
or can be omitted entirely* 

Asynchronous transaction output processing 
programs (only required if the asynchronous 
transaction processing facility is being used) . 

User—written exit routine used with asynchronous 
transaction processing transactions CRDR and CWTR. 

An entry, for each transaction list table generated 
by the user with the DFHXLT macro instruction. 

Node abnormal condition program. 

Node error program linked to by DFHZNAC. This is 
either the interface module generated by the 
DFHZNEPI macro, or the only user-written node 
error program. 

Response logging program. Required for VTAM. 

Resend program. Required for VTAM support if 
message resynchronization requires retransmission 
of any in-doubt committed output message (See 
■message Recovery and Resynchronization* in 
Chapter 4.8.) 

User-written program to edit input data and 
transfer control to the appropriate transaction. 


User— — The names of any recovery programs from the 

specified system recovery table. 

name 


User- 

specified 

name 


User- 

specified 

name 


An entry is required for each mapset name for 
for input and output basic mapping support 
operations. The RELOAD=YES option of the PPT 
must not be used with BMS maps. 

An entry is required for each user node error 
program as specified by the DFHZNEP module 
generated by the DFHZNEPI macro. 


The following entries are required if the PL/I Optimizer—supplied 
PL/I—CICS/VS support is to be installed. See the PL/I Optimizing 
Compiler: Installation manual for details. 

IBMBCCLA, IBMBCCRA (OS/VS only) , ‘IBMBEOCA, IBMBETAA, IBMBETBA, IBMBETCA, 
IBMBETIA, IBMBETOA, IBMBETPA, IBMBETQA, IBMBETTA, IBMDCCRA (DOS/VS 
only), IBMFEFCA, IBMFESMA, IBMFESNA, IBMFKCSA, IBMFKMRA, IBMFKPTA, 

| IBMFKTRA, IBMFKTCA, IBMFKTRA, IBMFPGDA, IBMFPMRA, IBMFSTVA. 

These entries may be generated as a functional group through the 
FN=PL/I operand of DFHPPT TYPE=jGROUP. 

Records to define such entries are provided as part of the PL/I 
installation information. 
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Location 


Macro/Operand Specified Related Macro/Qperand 


command level 
statement* 


* DFHTCT TYPE=LINE ANSWRBK= 


FEATURE^ 

AUTOPOLL 


The corresponding options 
must also be specified 
in the ANSWRBK operand 
Of DFHSG PROGRAM=TCP. 

FEATURE=SCONTROL must 
also be specified for 
2740. 


ANSWRBK^ 

POOLADR= 


♦ DFHTCT TYPE=SDSCI DSCNAME= 


LERBADR= 


♦ DFHTCT TYPE=TERMINAL TRMIDNT= 


FEATURE=AUTOANSR must 
be specified for both 
these operands. 

The name specified must 
be the same as that in 
ISADSCN and OSADSCN in 
DFHTCT TYPE=LINE for 
sequential data sets. 

For BTAM data sets, 
DSCNAME must be the same 
as that in DSCNAME in 
DFHTCT TYPE=LINE• 

Is only required when 
ERROPT=C is specified in 
this macro. 

Must be the same as in 
DESTID in DFHDCT TYPE= 
INTRA for terminal 
destinations. 


UCTRAN must be 
specified in DFHSG 
PROGRAM=TCP• 

Specifies the terminal 
type s 

a) If not already 
specified in DFHTCT TYPE 
LINE 

b) To override the above 
specification. 

The following table provides information on how to specify, through 
the TRMTYPE and SESTYPE operands of DFHTCT TYPE=TERMINAL, some of the 
possible configurations for 3270 devices, some of which may be used to 
provide alternative screen size support. TRMTYPE and SESTYPE 
specifications are given for local, BSC, and SDLC connections. 


FEATURE= 
UCTRAN 

TRMTYPE— 


Appendix D. Cross-Reference Table 
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| Devices 


| Connection 


| TRMTYPE= 


| SESTYPE= | 


I 

I 
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INDEX 


Each page number in this index refers to the start of the paragraph containing the 
indexed item* Where more than one page reference is given, the major reference is first. 


abend 

abend/restart, TCAM 486 
codes — DFHSRT TYPE=SYSTEM/USER 225 
DFHSRT TYPE=SYSTEM/USER 225 
DOS/VS codes 226 
OS/VS codes 226 
recovery 226 
system or user codes 225 
transaction bit 353 
ABKPOPT operand 199 
abnormal termination 378,389 
ACB (see access method control block) 
access method control block (ACB) 449 
ACCMETH operand 

DFHFCT TYPE=ALTERNATE 119 
DFHFCT TYPE =DATASET 122 
DFHSG PROGRAM=TCP 69 
DFHTCT TYPE=INITIAL 235 
DFHTCT TYPE=ISLINK 243 
DFHTCT TYPE=LINE 251 
DFHTCT T YPE=TERMINAL 277 
accounting information 14 
ACCTID operand 14 
action bits, TACLE 352 
action flag names, DFHTEP 333 
action flags set by DFHZNAC 460 
active tasks 433 
activity keypointing 

DFHSG PROGRAM=KPP 60 
frequency 199 
user 436 

address of each terminal 240 
ADRSPCE operand 99,158 

ageing limit, temporary storage data 306 
AKP operand 60 
AKPFREQ operand 199 
ALIGN operand 98,157 
alignment, trace table entries 159 
ALT — application load table (see 
DFHALT) 97 

alternate index structure 133 
alternate page size 277 
alternate screen size 239,278 
alternative printer 277 
ALTPGE operand 277 
ALTPRT operand 290 
ALTSCRN operand 239,278 
AMXT operand 199 
ANS COBOL compilers 63 
answering list 257 
ANSWRBK operand 70,254 
anticipatory paging 

ANTICPG operand 166 
SVC, CICSSVC operand 19 
ANTICPG operand 166 
appendage routine, 7770 41,270 

APPENDG operand 270 
application function timings 560 
application load table (see DFHALT) 97 
application programming, journal 
control 397 


(continued) 

closing journal data sets — DFHJC 
TYPE=CLOSE 400 

opening journal data sets — DFHJC 
TYPE=OPEN 397 

reading journal data sets — DFHJC 
TYPE=GET 401 
APPLID operand 
DFHSIT 200 

DFHTCT TYPE-INITIAL 235 
VTAM 449 

ARGTYP operand 137 
argument type 137 
ASMBLR operand 15 
assembler programs 

LANG operand 47,52 
PGMLANG operand 188 

asynchronous transaction processing 517 
CRDR exit routine 518 
CWTR exit routine 519 
program (see DFHSG PROGRAM=ATP) 23 
user exits 517 

ATP — asynchronous transaction processing 
program (see DFHSG PROGRAM=ATP) 23 
ATP operand 200 
ATPMB operand 200 
ATPMT operand 200 
audible alarm feature 284 
AUTOJRN operand 50,56 
automatic 

answering feature 256 
calling feature 256 
journaling 50,56 

logical units 170 
logging 57,394 

to system log 129 
logon 282 

polling feature 256 
statistics 38,621 
task/transaction initiation 
(ATI) 71,463 

automatically initiated BASE 
transactions 555 
autopoll feature 268 
AUTOTRN operand 71 
AUX operand 84,86 
auxiliary storage 86 
average response times 
estimating 618 

average service time, disks 605 


background pathlengths 568 
background processor utilization 557 
BASE operand 133 
BASE transaction timings 559 
basic function, DFHSG PROGRAM=BFP 25 
basic mapping support program (see DFHSG 
PROGRAM—BMS) 26 

bdtch data interchange program (see DFHSG 
PRO GRAM=D IP) 45 
batch processing, TCAM SNA 470 


Index 
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batch region communication, DFHTCT 
TYPE=IRCBCH 242 
BDAM reference set 590 

BFP, built-in functions program (see DFHSG 
PROGRAM=BFP) 25 

binary synchronous communication 
BSCODE operand 71,254 
CONFIG operand 266 
DFHTCT TYPE=LINE 250 
line configuration 266 
BLKKEYL operand 124 
BLKSIZE operand 

DFHDCT TYPE=SDSCI 109 
DFHFCT TYPE=DATASET 124 
DFHTCT TYPE=SDSCI 265 
block size 239,265 
block size, restart data set 61 
blocking factor 133 
BMS 

BMSFEAT operand 278 

device—dependent mapsets 28,188 

DFHSG PROGRAM=BMS 26 

diagnostics 29 

logical units 465 

map use count 191 

mapset suffixes 188 

operand of DFHSIT 201 

page building routines 31 

page commands of DFHSIT 208 

page—retrieval command 208 

pageout routines 31 

printer support 31 

program (see DFHSG PROGRAM=BMS) 26 
purge routines 31 
system generation 26 
text building routines 32 
BMS — basic mapping support program 
(DFHSG PROGRAM=BMS) 26 


BMS features 278 

BMSCPYC operand 

27 

BMSDDS operand 

27 

BMSDEV operand 

28,465 

BMSDIAG operand 

29 

BMSDRT operand 

30 

BMSFEAT operand 

278 

BMSFMP operand 

30 

BMSFRL operand 

30 

BMSMBD operand 

30 

BMSNL operand 30 

BMSOBF operand 

31 

BMSPB operand 31 

BMSPGO operand 

31 

BMSPRG operand 

31 

BMSPROP operand 

31 

BMSRCVR operand 

32 

BMSSMI operand 

32 

BMSTAB operand 

32 

BMSTXB operand 

32 

BRACKET operand 

279 

bracket protocol 279 

BSCODE operand 



DFHSG PROGRAM=TCP 71 
DFHTCT TYPE=LINE 254 
DFHTCT TYPE=SDSCI 265 
BTAM 

BTAMDEV operand 7 2 

BTAMRLN operand 255 

define—terminal—list macro 257 


BTAM (continued) 

device types 72,263 
DFTRMLST macro 293 
expanded ID verification 254 
IRBUFSZ operand 237 
module names 236 

multiprocessor recovery procedures 
print feature 285 
reference set 588 
relative line number 255 
storage requirements 588 
terminal address 293 
terminal errors 

terminal abnormal condition 
program 325 

terminal control program 325 
terminal error program 325 
BTAMDEV operand 72 
BTAMRLN operand 255 
buffer 

BUFSIZE operand 149 
BUFSUV operand 149,396 
depletion, 3600 BSC 506 
dynamic 202 

expansion feature (2980) 285 

factors in selecting size 395 
maximum size 395 
minimum size 395 
operand 279 
pool size 216 
receive feature 256 
shift—up value 149,395 
size 394 
sizes 279 
BUFFER operand 453 
buffers 

BUFFER operand 

DFHTCT TYPE=TERMINAL 279 
BUFFERS operand 

DFHFCT TYPE=SHRCTL 144 
BUFND operand 

DFHFCT TYPE=ALTERNATE 120 
DFHFCT TYPE=DATASET 125 
BUFNI operand 

DFHFCT TYPE=DATASET 125 
BUFNO operand 

DFHDCT TYPE=SDSCI 109 
BUFSP operand 

DFHFCT TYPE=DATASET 125 
BUFND operand 120,125 
BUFNI operand 120,125 
BUFNO operand 109 
BUFPL operand 216 
BUFSIZE operand 149 
BUFSP operand 125 
BUFSUV operand 149,396 
built-in functions program (see DFHSG 
PRO GRAM=BFP) 25 
BUILTIN operand 25 


CAA operand 41 

calculate disk device service times 
data transfer time 599 
rotational position sensing 600 
seek time 599 

calculate transaction processor 


438 
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utilizations 

relative power factors 557 
chain assembly 73,281 
changing status of logical unit 527 
channel reconfiguration hardware (CRH) 438 
CHECK operand 542 
checking feature 
VRC/LRC 256 

checking outcome of DFHTC operation 527 
CHNASSY operand 

DFHSG PROGRAM=TCP 73 
DFHTCT TYPE=TERMINAL 281 
logical units 452 
CICS/OS/VS/TCAM interface 468 
TCAM 470 
TCAM SNA 468 
CICS/VS 

dynamic storage area 578 
function timings 559 
management programs 11 
module sizes 570 
performance aspects 551 
reference set 591 
service programs 11 
system generation 12 
system tables 97 
table sizes 575 

user exits for management programs 511 
utility program 11 
CICSDMP operand 44 
CICSSVC operand 19 
CLASS operand 

DFHALT TYPE=ENTRY 98 
DFHPCT TYPE=ENTRY 167 
DFHSG TYPE=INITIAL 21 
DFHTCT TYPE=LINE 255 
DFHTCT TYPE=TERMINAL 281 
closing data sets — DFHOC TYPE=CLOSE 545 
closing journal data sets — DFHJC 
TYPE=CLOSE 400 
CMPT60L operand 73 
CMXT operand 201 
COBOL 

compilers 63 
operand 63 
programs 

LANG operand 47,52 
PGMLANG operand 188 
code compatibility 

non—compatible interfaces 6 
object-compatible interfaces 5 
source—compatible interfaces 6 
CODE operand 

DFHSNEP TYPE =ERRPROC 371 
DFHTEPM TYPE =ERRPROC 340 
DFHTEPT TYPE=BUCKET 346 
DFHTEPT TYPE=PERMCODE/ERRCODE 344 
coding macro instructions 11 
command language translator program 
(see DFHSG PROGRAM=EXP) 47 
COMMAND operand 534 

command option (logical units) , DFHTC 
CTYPE=COMMAND 534 
committed output message 423 
common subroutine vector table 363,373 
common subroutines, DFHTEP 331 
common system system area (see DFHSG 
PROGRAM=CSA) 35 


common work area 36 

communicate with batch regions — DFHTCT 
TYPE=IRCBCH 

DL/I shared data base support 242 
communication control byte (s) 468,480 

communication lines — DFHTCT TYPE=LINE 
TCAM SNA devices 262 

terminal control table line entry 250 
COMPAT operand 

DFHPCT TYPE=ENTRY 168 
DFHSG PROGRAM=BMS 33 
DFHSG PROGRAM=TCP 74 
DFHTCT TYPE—TERMINAL 281 
CONDCD operand 21 
CONFIG operand 266.1 
configurator 
DFHFCT 117 
DFHTCT 228 

CONN ECT=AUTO operand 282,450 
control block and area prefix fields 6 
control system dummy group (see DFHSG 
PROGRAM=CSD) 36.1 

control system operational group (see 
DFHSG PROGRAM=CSO) 37 
control system service group (see DFHSG 
PROGRAM=CSS) 41 

control system utility group (see DFHSG 
PRO GRAM=CSU) 42 
control unit address 239 
conversational ECHO transactions 555 
conversational transactions 591 
CONVTAB operand 74,255 
copy feature 284 

count limits, default threshold 344 
COUNT operand 344,368 

CRDR exit routine, input processor (ATP) 
creating system or user abend exit 
selective transaction abend 389 
TCAPCARO field 389 
creating task abend exit 382 
cross-index data set record — DFHFCT 
TYPE=INDACC 136 
cross-reference table 669 
CS=NO operand 366 

CSA — common system area (see DFHSG 
PROGRAM=CSA) 35 
CSA operand 201 

CSD, control system dummy (see DFHSG 
PROGRAM=CSD) 36.1 

CSO, control system operational group (see 
DFHSG PROGRAM=CSO) 37 
CSS, control system service group (see 
DFHSG PROGRAM—CSS) 41 
CSU, control system utility group (see 
DFHSG PROGRAM=CSU) 42 
CTLCHAR operand 111 
CTYPE macros, DFHTC 527 
CTYPE =C HE CK 532 
TYPE=COMMAND 534 
TYPE—LOCATE 527 
TYPE=STATUS 529 
CTYPE=CHECK operand 533 
CTYPE=COMMAND operand 534 
CTYPE=~LOCATE operand 528 
CTYPE—STATUS operand 530 
CU operand 267 
CUADDR operand 239 
CUFEAT operand 239 
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CUPOSN operand 239 
CWTR exit routine, output processor 
(ATP) 519 
cylinder 

index area 127 
overflow records 132 
CYLOFL operand 132 


DASD 

seek times 602 
timing data 600 
data base backout, DFHTBP 421 
data base description block (DBD) 
operand 320 
data buffers 125 

data definition (DD) statement 270 
data format, TCAM 472 
data management block (DMB) 217 
DATA operand 120,134 
data set 

control blocks 108 
control information — DFHDCT 
TYPE=SDSCI 108 
control information — DFHTCT 
TYPE=SDSCI 262 
control name 256,264 
definition, DFHFCT TYPE=DATASET 120 
duplicate 137 

nonresident extrapartition 112 
recovery 417 
data transfer time 599 
data written to system log 423 
DATAID operand 306,307 
DATASET operand 

DFHFCT TYPE=ALTERNATE 119 
DFHFCT TYPE=DATASET 121 
DFHFCT TYPE=REMOTE 139 
DFHOC TYPE=CLOSE 545 
DFHOC TYPE=OPEN 541 
DATASET=DUMP operand 546 
DATFORM operand 36,202 
DBD operand 320 
DBP operand 202 

DBP, dynamic backout program (see DFHSG 
PROGRAM=DBP) 42 
DBUFSZ operand 202 
DCB information 262 

DCP — dump control program (see DFHSG 
PROGRAM=DCP) 44 
DCP operand 202 

DCT — destination control table (see 
DFHDCT) 100 
DCT operand 202 
DD card correlation 471 
DDIR operand 216 
DDNAME operand 270 
deadlock timeout value 169 
DEBCHK operand 19 
deblocking technique 137 
DECB 

information 333 
operand 333 
default 

actions taken by DFHTACP 
DFHTEP 677 
TCAM 480 

data base backout 421 


default (continued) 

load order (DFHNLT) 152 
page size 287 

threshold count limits 344,346 
transaction—class routine 370 
3270 screen size 283 
DEFAULT operand 370 

define terminal error blocks, DFHTEPT 
TYPE=PERMTID 343 

defining transactions and transaction rates 
automatically initiated BASE 
transactions 555 

conversational ECHO transactions 555 
ECHO transactions 555 
transaction types 555 
DEFSCRN operand 283 
derivation of input data 

average service time, disks 605 
DESTFAC operand 105 
DESTID operand 

DFHDCT TYPE=EXTRA 103 
DFHDCT TYPE=INDIRECT 105 
DFHDCT TYPE=INTRA 105 
DFHDCT TYPE=REMOTE 107 
destination control table (see DFHDCT) 100 
destination selection 246 
DESTRCV operand 82,105 
DEVADDR operand 

DFHDCT TYPE=SDSCI 111 
DFHJCT TYPE=ENTRY 151 
DFHSG PROGRAM=DCP 45 
DFHSG PROGRAM=TRP 85 
DFHTCT TYPE=SDSCI 267 
device 

classification 255,281 
message handler control 468.1 
types 

BTAM 72 
VTAM 79 
DEVICE operand 

DFHDCT TYPE=INITIAL 102 
DFHDCT TYPE=SDSCI 111 
DFHFCT TYPE=DATASET 132 
DFHSG PROGRAM=DCP 45 
DFHSG PROGRAM=KPP 61 
DFHSG PROGRAM=TCP 75 
DFHSG PROGRAM=TRP 85 
DFHSG TYPE=INITIAL 19 
DFHTCT TYPE=SDSCI 263 
device-dependent mapset suffixes 28,188 
DFHALT 97 

control section — DFHALT 
TYPE=INITIAL 97 

end of application load table — DFHALT 
TYPE=FINAL 99 

program load sequence — DFHALT 
TYPE=ENTRY 97 
DFHALT TYPE=ENTRY 

ADRSPCE operand 99 
ALIGN operand 98 
CLASS operand 98 
FIX operand 98 
page alignment 98 
page fixing 99 
PAGEOUT operand 99 
PROGRAM operand 98 
TYPE=ENTRY operand 98 
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DFHALT TYPE=FINAL 

TYPE=FINAL operand 99 
DFHALT TYPE=INITIAL 
SUFFIX operand 97 
TYPE=INITIAL operand 97 
DFHBIF TYPE=PHONETIC 547 
DFHDCT 100 

control section — DFHDCT 
TYPE—INITIAL 101 

data set control information — DFHDCT 
TYPE=SDSCI 108 

end of destination control table — 
DFHDCT TYPE=FINAL 111 
examples 112 

extrapartition destinations — DFHDCT 
TYPE=EXTRA 103 

indirect data destinations — DFHDCT 
TYPE=INDIRECT 104 

intrapartition destinations — DFHDCT 
TYPE=INTRA 105 

nonresident extrapartition data 
sets 112 

remote transient data destinations — 
DFHDCT TYPE=REMOTE 107 
required entries 621 
trigger level 100 
DFHDCT TYPE=EXTRA 

DESTID operand 103 
DSCNAME operand 103 
OPEN operand 104 
RESIDNT operand 10 4 
TYPE=EXTRA operand 103 
DFHDCT TYPE=FINAL 

TYPE=FINAL operand 112 
DFHDCT TYPE=INDIRECT 
DESTID operand 105 
INDDEST operand 105 
TYPE=INDIRECT operand 104 
DFHDCT TYPE=INITIAL 
DEVICE operand 102 
INDEX operand 101 
SEPASMB operand 101 
SUFFIX operand 102 
TRNSUFX operand 102 
TYPE-INITIAL operand 101 
DFHDCT TYPE=INTRA 

DESTFAC operand 105 
DESTID operand 105 
DESTRCV operand 105 
enqueue lockout 105 

logically recoverable destinations 106 
physically recoverable destinations 105 
REUSE operand 106.1 
TRANSID operand 107 
trigger level 107 
TRIGLEV operand 107 
TYPE=INTRA operand 105 
DFHDCT TYPE=REMOTE 

DESTID operand 107 
LENGTH operand 108 
RMTNAME operand 108 
SYSIDNT operand 108 
TYPE=REMOTE operand 107 
DFHDCT TYPE=SDSCI 

BLKSIZE operand 109 
BUFNO operand 109 
CTLCHAR operand 111 
DEVADDR operand 111 


DFHDCT TYPE=SDSCI (continued) 

DEVICE operand 111 
DSCNAME operand 109 
ERROPT operand 109 
FILABL operand 111 
MODNAME operand 111 
RECFORM operand 109 
RECSIZE operand 109 
REWIND operand 110 
SUFFIX operand 110 
TPMARK=N0 operand 111 
TYPE=SDSCI operand 108 
TYPEFLE operand 110 
variable length records 110 
DFHDLDBD 319 
DFHDLPSB 317 
DFHFCT 116 

configurator 117 
control section — DFHFCT 
TYPE=INITIAL 118 

cross—index data set record — DFHFCT 
TYPE=INDACC 136 

data sets — DFHFCT TYPE=DATASET 120 
end of file control table — DFHFCT 
TYPE=FINAL 144 
examples 145 
file management 116 

header of segmented record — DFHFCT 
TYPE=SEGHEAD 141 
last segment set — DFHFCT 
TYPE=SEGLAST 142 

remote files — DFHFCT TYPE=REMOTE 139 
segment sets — DFHFCT TYPE=SEGSET 142 
segments of segmented record — DFHFCT 
TYPE=SEGDEF 140 

superset ISAM logic module — DFHFCT 
TYPE=LOGICMOD 138 

VSAM ICIP mixed mode access — DFHFCT 
TYPE=ALTERNATE 118 

VSAM shared resources control — DFHFCT 
TYPE=SHRCTL 143 
DFHFCT TYPE=ALTERNATE 
ACCMETH operand 119 
BUFND operand 120 
BUFNI operand 120 
DATA operand 120 
DATASET operand 119 
INDEX operand 120 
JID operand 120 
JREQ operand 120 
LOG operand 120 
PASSWD operand 120 
RECFORM operand 120 
SERVREQ operand 119 
STRNO operand 120 
STRNOG operand 120 
TYPE=ALTERNATE operand 119 
DFHFCT TYPE=DATASET 

ACCMETH operand 122 

alternate index structure 133 

automatic logging to system log 129 

BASE operand 133 

BLKKEYL operand 124 

BLKSIZE operand 124 

blocking factor 133 

BUFND operand 125 

BUFNI operand 125 

BUFSP operand 125 
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DFHFCT TYPE=DATASET (continued) 
cylinder index area 127 
cylinder overflow records 132 
CYLOFL operand 132 
DATA operand 134 
DATASET operand 121 
DEVICE operand 132 
EXTENT operand 133 
file service requests 123 
FILSTAT operand 126 
format of records 130 
INDAREA operand 126 
INDEX operand 134 
index skip feature 133 
INDSIZE operand 126 
INDSKIP=YES operand 133 
IOSIZE operand 127 
IOWORK operand 134 
J1D operand 127 
journal file identification 127 
journaling requests 128 
JREQ operand 128 
keyfield 131 
KEYLEN operand 128 
LOG operand 129 
logical key length 128 
logical record length 129 
LRECL operand 129 
master index 133 
maximum number of extents 133 
mixed mode files (VSAM ICIP) 135 
MODE operand 135 
MSTIND=YES operand 133 
multiple track search 132 
NRECDS operand 133 
OPEN operand 130 
parity check 132 
PASSWD operand 130 
physical key length 124 
RECFORM operand 130 
relative addressing 131 
RELTYPE operand 131 
RKP operand 131 
SERVREQ operand 122 
SRCHM operand 131 
strings 132 
strings (GET only) 136 
STRNO operand 132 
STRNOG ope rand 136 
TYPE=DATASET operand 121 
VERIFY=YES operand 132 
VSAM buffers 125 
DFHFCT TYPE=FINAL 

TYPE=FINAL operand 145 
DFHFCT TYPE=INDACC 

ARGTYP operand 137 

argument type 137 

deblocking technique 137 

DUPDSID operand 137 

duplicate data set 137 

IADADMI operand 137 

IADIII operand 137 

IALKFL operand 136 

IARLKP operand 136 

OBJDSID operand 137 

object data set 137 

record identification field 136 

search argument type 138 


DFHFCT TYPE=INDACC (continued) 

SRCHTYP operand 137 
TYPE=INDACC operand 136 
DFHFCT TYPE=INITIAL 
SUFFIX operand 118 
TYPE=INITIAL operand 118 
DFHFCT TYPE=LOGICMOD 

rotational position sensing 139 
RPS=SVA operand 139 
TYPE=LOGICMOD operand 139 
DFHFCT TYPE=REMOTE 

DATASET operand 139 
KEYLEN operand 139 
LRECL operand 140 
RMTNAME operand 140 
SYSIDNT operand 139 
TYPE=REMOTE operand 139 
DFHFCT TYPE=SEGDEF 

SEGLENG operand 140 
segment characteristics 140 
segment length 140 
SEGNAME operand 140 
TYPE=SEGDEF operand 140 
DFHFCT TYPE=SEGHEAD 

INDDISP operand 141 
SEGLENG operand 141 
segment indicator field 141 
TSEGIND operand 141 
type of segment indicator field 141 
TYPE=SEGHEAD operand 141 
DFHFCT TYPE=SEGLAST 

TYPE—SEGLAST operand 142 
DFHFCT TYPE=SEGSET 

SEGNAME operand 143 
SEGSET operand 142 
TYPE=SEGSET operand 142 
DFHFCT TYPE=SHRCTL 

BUFFERS operand 144 
KEYLEN operand 144 
maximum key length 144 
resource limit 144 
RSCLMT operand 144 
STRNO operand 144 
TYPE^SHRCTL ope rand 143 
DFHJC TYPE= (GETJCA,OPEN) 415 
DFHJC TYPE=CLOSE 400 
IDERROR operand 400 
IOERROR operand 400 
JFILEID operand 401 
LEAVE operand 401 
NORESP operand 401 
STATERR operand 401 
TYPE=CLOSE operand 400 
DFHJC TYPE=GET 401 

EOFADDR operand 403 
IDERROR operand 403 
INVREQ operand 403 
IOERROR operand 403 
JFILEID operand 403 
NORESP operand 403 
NOTOPEN operand 403 
STATERR operand 403 

TYPE=GETB/GETF/NOTE/POINT operand 402 
VOLERR operand 403 
DFHJC TYPE=OPEN 397 
IDERROR operand 398 
INVREQ operand 398 
IOERROR operand 398 
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DFHJC TYPE=OPEN (continued) 

JFILEID operand 398 
NORESP operand 398 
SIVOL=YES operand 398 
STATERR operand 399 
TYPE=OPEN operand 397 
VOLERR ope rand 399 
volume error 399 
VOLUME operand 399 
DFHJCT 148 

control section — DFHJCT 
TYPE=INITIAL 148 

end of journal control table — DFHJCT 
TYPE=FINAL 151 
example 151 

journal entries — DFHJCT 
TYPE=ENTRY 148 
DFHJCT TYPE=ENTRY 

buffer shift—up value 149 
BUFSIZE operand 149 
BUFSUV operand 149 
DEVADDR operand 151 
JDEVICE operand 151 
JFILEID operand 149 
journal file identification 149 
journaling options 149 
JOUROPT operand 149 
JTYPE operand 149 
OPEN operand 150 
SYSWAIT operand 150 
type of journal data set 149 
TYPE=ENTRY operand 148 
volume switching 149 
DFHJCT TYPE=FINAL 

TYPE=FINAL operand 151 
DFHJCT TYPE=INITIAL 
SUFFIX operand 148 
TYPE=INITIAL operand 148 
DFHKP TYPE=CHECK 

EOFADDR operand 436 
IOERROR operand 436 
NORESP operand 436 

test transaction backout response 435 
TYPE=CHECK operand 435 
DFHKP TYPE=RTBOCTL 

EOFADDR operand 434 
IOERROR operand 434 
NORESP operand 434 
read transaction backout control 
record 434 

TYPE=RTBOCTL operand 434 
DFHKP TYPE=RTBODATA 

EOFADDR operand 435 
IOERROR operand 435 
NORESP operand 435 
read transaction backout data 434 
TYPE=RTBODATA operand 435 
DFHKP TYPE=RTBOEND 

reset transaction backout pointer 435 
TYPE=RTBOEND ope rand 435 
DFHNLT 152 

control section — DFHNLT 
TYPE=INITIAL 156 
default load order 152 
end of nucleus load table — DFHNLT 
TYPE=FINAL 158.1 
examples 158.1 


DFHNLT (continued) 

module load sequence — DFHNLT 
TYPE=ENTRY 156 
trace table alignment 159 
DFHNLT TYPE=ENTRY 

ADRSPCE operand 158 
ALIGN operand 157 
FIX operand 157 
MODULE operand 157 
nucleus module name 157 
page alignment 157 
page fixing 157 
PAGEIN operand 158 
PAGEOUT operand 158 
PROTECT operand 158.1 
TYPE=ENTRY operand 156 
DFHNLT TYPE=FINAL 

TYPE=FINAL operand 158.1 
DFHNLT TYPE=INITIAL 
SUFFIX operand 156 
TYPE=INITIAL operand 156 
DFHOC TYPE=CLOSE 

DATASET operand 545 
DSETID operand 545 
TYPE=CLOSE operand 545 
DFHOC TYPE=OPEN 

CHECK operand 542 
DATASET operand 541 
destination identification 542 
DSETID operand 542 
ICIP and mixed mode files 544 
LISTADR operand 543 
MODE operand 544 
SYMBADR operand 545 
TYPE=OPEN operand 541 
DFHOC TYPE-SWITCH 

DATASET=DUMP operand 546 
TYPE=SWITCH operand 545 
DFHPC TYPE=SETXIT macro 381 
DFHPCT 161 

control section — DFHPCT 
TYPE=INITIAL 161 

end of program control table — DFHPCT 
TYPE=FINAL 179 
examples 180 
required entries 622 
required entries — DFHPCT 
TYPE=GROUP 176 

transaction control information — 
DFHPCT TYPE=ENTRY 163 
transaction description options — 
DFHPCT TYPE=OPTGRP 178 
TWASIZE 623 
DFHPCT TYPE=ENTRY 

anticipatory paging 166 
ANTICPG operand 166 
automatic journaling for logical 
units 170 
CLASS operand 167 
COMPAT operand 168 
deadlock timeout feature 169 
DTB operand 168 
DTIMOUT operand 169 
DUMP operand 169 
DVSUPRT operand 169 
dynamic transaction backout 168 
FDUMP operand 169 
INBFMH operand 170 
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DFHPCT TYPE=ENTRY (continued) 

JFILEID operand 170 
logical record presentation 170 
LOGREC operand 170 
message option group 171 
MSGJRNL operand 170 
NEPCLAS operand 171 
OPTGRP operand 171 
primed storage allocation 175 
PRIVATE operand 171 
PRMSIZE operand 175 
PROGRAM operand 164 
read timeout feature 172 
RESTART operand 171 
RMTNAME operand 172 
RTIMOUT operand 172 
SCRNSZE operand 172 
SPURGE operand 173 
SYSIDNT operand 173 
system stall purge indicator 173 
TASKREQ operand 164 
TCLASS operand 173 
terminal error purge indicator 174 
TIOTYPE operand 174 
TPURGE operand 174 
transaction class 173 
transaction I/O processing 174 
transaction priority 175 
transaction restart facility 171 
transaction security key 174 
transaction work area size 175 
TRANSEC operand 174 
TRANSID operand 165 
TRNPRTY operand 175 
TRNSTAT operand 175 
TVJASIZE operand 175 
TYPE=ENTRY operand 164 
XTRANID operand 175 
DFHPCT TYPE=FINAL 

TYPE=FINAL operand 180 
DFHPCT TYPE=GROUP 
FN operand 176 
functional groups 176 
required entries 622 
TYPE=GROUP operand 176 
DFHPCT TYPE=INITIAL 
DTB operand 162 

dynamic transaction backout 162 
FDUMP operand 162 
formatted dump program 162 
INDEX operand 162 
indexing 162 
SCRNSZE operand 163 
SUFFIX operand 163 
TYP E=INITIAL operand 161 
DFHPCT TYPE=OPTGRP 455 
message integrity 179 
message option groups 178 
message protection 179 
MSGPOPT operand 179 
MSGPREQ operand 179 
TYPE=OPTGRP operand 179 
DFHPEP 383 
DFHPLT 182 

control section — DFHPLT 
TY PE=INITIAL 183 

end of program list table — DFHPLT 
TYPE=FINAL 185 


DFHPLT (continued) 

entries in program list table — DFHPLT 
TYPE=ENTRY 184 
example 185 

first quiesce stage 183 
post—initialization phase 182 
system initialization processing 182 
DFHPLT TYPE=ENTRY 

PROGRAM operand 184 
PROGRAM=DFHDELIM operand 184 
PROGRAM=DLZSTP00 operand 185 
TYPE=ENTRY operand 184 
DFHPLT TYPE=FINAL 

TYPE=FINAL operand 185 
DFHPLT TYPE=INITIAL 
SUFFIX operand 184 
TYPE=INITIAL operand 184 
DFHPPT 186 

control section — DFHPPT 
TYPE=INITIAL 186 

end of processing program table — 

DFHPPT 194 
example 194 

processing programs — DFHPPT 
TYPE-ENTRY 187 
required entries 625 
required entries — DFHPPT 
TYPE-GROUP 191 
DFHPPT TYPE=ENTRY 

BMS device-dependent mapsets 188 
forced pageout 190 
mapset suffixes 188 
PGMLANG operand 188 
PGMSTAT operand 188 
program load request 188 
PROGRAM operand 187 
RELOAD operand 188 
RES operand 189 
TYPE=ENTRY operand 187 
USAGE=MAP operand 190 
use count for BMS maps 191 
DFHPPT TYPE=FINAL 

TYPE=FINAL operand 194 
DFHPPT TYPE=GROUP 

execution diagnostic facility (EDF) 192 
FN operand 191 
functional groups 191 
required entries 625 
TYPE=GROUP operand 191 
DFHPPT TYPE=INITIAL 
INDEX operand 187 
SUFFIX operand 187 
TYPE-INITIAL operand 186 
DFHSG 13 

PROGRAM=ATP 23 
PROGRAM=BFP 24 
P ROGRAM=BMS 26 
P ROGRAM=C SA 35 
PROGRAM=C SD 36.1 
PROGRAM=CSO 37 
PROGRAM=CSS 41 
PROGRAM=CSU 42 
PROGRAM=DBP 42 
PROGRAM=DCP 44 
PROGRAM=DIP 45 
PROGRAM=EIP 46 
PROGRAM=EXP 47 
PROGRAM=FCP 48 
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DFHSG (continued) 


PROGRAM=GAP 

51 

PROGRAM=HLL 

52 

PROGRAM=ICP 

53 

PROGRAM=ISC 

54 

PROGRAM=j CP 

55 

PRO GRAM=KC P 

58 

PRO GRAM=KP P 

59 

PROGRAM=MTP 

61 

PROGRAM=OCP 

62 

PROGRAM=PCP 

62 

PRO GRAM=RS P 

64 

PROGRAM=SCP 

65 

PROGRAM=SRP 

66 

PROGRAM=TBP 

67 

PROGRAM=TCP 

68 

PROGRAM=TDP 

81 

PROGRAM=TRP 

84 

PROGRAM=TSP 

85 

TYPE=FINAL 

87 

TYPE=INITIAL 

13 
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DFHSG PROGRAM=FCP (continued) 
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DFHSG PROGRAM=TCP (continued) 
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DFHSIT (continued) 
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DFHSRT TYPE=SYSTEM/USER (continued) 
user—supplied abend code 225 
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DFHTCT TYPE=ISLINK (continued) 
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DFHTCT TYPE=LINE (continued) 
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DFHTCT TYPE=TERMINAL (continued) 
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DFHTCT TYPE=TERMINAL (continued) 
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DFHTEPT TYPE=INITIAL (continued) 
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TYPE=ENTRY operand 303 
DFHTLT TYPE=FINAL 

TYPE=FINAL operand 304 
DFHTLT TYPE=INITIAL 
LDC operand 303 
SUFFIX operand 303 
TYPE=INITIAL operand 303 
DFHTST 305 

control section — DFHTST 
TY PE=I NIT IAL 305 
end of temporary storage table — 

DFHTST TYPE=FINAL 308 
example 308 

remote queues — DFHTST TYPE=REMOTE 307 
temporary storage dataids, DFHTST 
TYPE =RE COVERY/ENTRY 306 
DFHTST TYPE=FINAL 

TYPE=FINAL operand 308 
DFHTST TYPE=INITIAL 
SUFFIX operand 306 
temporary storage ageing limit 306 
TSAGE operand 306 
TYPE=INITIAL operand 306 
DFHTST TYPE—RECOVERY/ENTRY 
DATAID operand 306 
TYPE=RECOVERY/ENTRY operand 306 
DFHTST TYPE=REMOTE 

DATAID operand 307 
RMTNAME operand 307 
SYSIDNT operand 307 
TYPE=REMOTE operand 307 
DFHXLT 308 

control section — DFHXLT 
TY PE—INIT IAL 309 

end of transaction list table — DFHXLT 
TYPE=FINAL 310 

entries in transaction list table, 

DFHXLT TYPE=ENTRY 309 
example 310 
DFHXLT TYPE=ENTRY 

TASKREQ operand 309 
transaction code 309 
TRANSID operand 309 
TYPE=ENTRY operand 309 
DFHXLT TYPE=FINAL 

TYPE=FINAL operand 310 
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DFHXLT TYPE=INITIAL 
SUFFIX operand 309 
TYPE=INITIAL operand 309 
DFHZCP, user exit routines 464 
DFHZNAC 

action flags set 460 
logging facility 462 
system sense codes received 698 
DFHZNEPI macros 

DFHZNEPI TYPE=ENTRY 370 
DFHZNEPI TYPE=FINAL 371 
DFHZNEPI TYPE-INITIAL 370 
DFHZNEPI TYPE=ENTRY 370 
NEPCLAS operand 370 
NEPNAME operand 371 
transaction-class error—handling 
routine 370 
DFHZNEPI TYPE=FINAL 

TYPE=FINAL operand 371 
DFHZNEPI TYPE=INITIAL 
DEFAULT operand 3 70 
DFTRMLST macro 
BTAM 257,293 

digital response messages 299 
DIP operand 202 

DIP, batch data interchange program (see 
DFHSG PROGRAM=DIP) 45 
disconnect switched line bit 353 
disk device service times 
DASD seek times 602 
DASD timing data 600 
disk extents , nonsequential 40 
DISMSG operand 283 
DL/I 

backout 426 
backout table 420 
buffer pool size 216 
DDIR 317 
DDIR operand 216 
DFHDLDBD 319 
DFHDLPSB 317 
DLI operand 

DFHDLDBD 319 
DFHDLPSB 318 
DFHSG PROGRAM=DBP 43 
DFHSG PROG RAM=TBP 68 
DFHSG TYPE=INITIAL 15 
DFHSIT 203 
DLTHRED operand 216 
DMBPL operand 217 
ENQ control block space 217 
error-exit 431 
generate DDIR (DFHDLDBD) 319 

generate PDIR (DFHDLPSB) 317 

IMS/VS control blocks 315 
inter—region communi cation 
PDIR 317 
PDIR operand 219 

program communication blocks (PCBs) 316 

program specification blocks (PSBs) 315 

PSB directory (PDIR) list 317 

PSB operand 220 

PSB pool size 220 

PSBPL operand 220 

reference set 590 
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DL/I (continued) 

restrictions on IMS/VS batch 
programmer 320 
scheduling 220 

shared data base support 54,242 
ACCMETH=IRC 70 
APPLID operand 200 
macros and operands 317 
programs 54 
system generation 92 
TCT example 663 
system generation 91,92 
table preparation 315 
with CICS/DOS/VS 91,315 
with CICS/OS/VS 
DBDs 315 
PCBs 315 
PSBs 315 

system generation 91 
DLTHRED operand 216 
DMBPL operand 217 
DOS/VS 

abend codes 226 
file names 240 
DSB operand 203 
DSCNAME operand 

DFHDCT TYPE=EXTRA 103 
DFHDCT TYPE=SDSCI 109 
DFHTCT TYPE=LINE 256 
DFHTCT TYPE=SDSCI 264 
DSECTPR operand 336 
DSETID operand 542,545 
DSN operand 246 
DTB operand 

DFHPCT TYPE=ENTRY 168 
DFHPCT TYPE=INITIAL 162 
DFHSG PROGRAM=JCP 57 
DTF information 262 
DTIMOUT operand 169 
dummy terminal indicator 353 
DUMMY=YES operand 

DFHSG PROGRAM=BFP 25 
DFHSG PROGRAM=BMS 33 
DFHSG PROGRAM=DCP 44 
DFHSG PROGRAM=DIP 45 
DFHSG PROGRAM =FCP 50 
DFHSG PROGRAM=JCP 57 
DFHSG PROGRAM=KPP 60 
DFHSG PROGRAM=SRP 66 
DFHSG PROGRAM=TDP 82 
DFHSG PROGRAM=TRP 84 
DFHSG PROGRAM=TSP 86 
dump control program (see DFHSG 
PROGRAM=DCP) 44 
DUMP operand 169 
DUPDSID operand 137 
duplicate data set 137 
DVC operand 246 
DVSUPRT operand 169,463 
dynamic buffer size 202 
dynamic log 202,386 
dynamic open/close 

closing data sets — DFHOC 
TYPE=CLOSE 545 
DFHOC macros 541 
opening data sets — DFHOC 
TYPE=OPEN 541 

program (see DFHSG PROGRAM=OCP) 62 


dynamic open/close (continued) 

switching dump data sets — DFHOC 
TYPE=SWITCH 545 
dynamic reference set 591 
dynamic storage area 
storage cushion 579 
temporary storage 579 
VSAM buffer storage 579 
working storage 578 
dynamic transaction backout 384 
DBP operand 202 
DTB operand 

DFHPCT TYPE=ENTRY 168 
DFHPCT TYPE=INITIAL 162 
DFHSG PROGRAM=JCP 57 
dynamic buffer 202,386 
dynamic log 202,386 
program (see DFHSG PROGRAM=DBP) 42 
recovery/restart 90 
transaction restart 312,386 
user exits 384 


ECHO transactions 555 
EDF (see execution (command level) 
diagnostic facility) 192,624 
EIP, exec interface program (see DFHSG 
PROGRAM=EIP) 46 
EJECT operand 16 
emergency restart 417 
data set recovery 417 
how to specify 212 
message logging (VTAM) 456 
post—initialization processing 418 
problem determination 417 
processing transaction backout data 432 
restart emergency restart 418 
system generation 90 
system log data set 418 
system restart data set 418 
table preparation 313 
temporary storage emergency restart 
interval control data recovery 432 
transaction backout 418 
user activity keypointing 436 
VTAM 457 

end—of-data indicator 75 
ENQ control block space 217 
ENQPL operand 217 
enqueue lockout 105 

entries in program list table — DFHPLT 
TYPE=ENTRY 184 
EODI=xx operand 75 
EOFADDR operand 

DFHJC TYPE=GET 403 
DFHKP TY PE=CHECK 436 
DFHKP TYPE=RTBOCTL 434 
DFHKP TYPE=RTBODATA 435 
EOM operand 267 
EOT operand 267 
ERRMSG operand 256 
ERROPT operand 109,265 
error messages and action flags 681 
error messages and codes 677 
DFHTACP 677 
DFHZNAC 681 
node error program 681 
terminal error program 677 
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error messages and default actions 677 
ERROR operand 

DFHTC CTYPE=CHECK 533 
DFHTC CTYPE=LOCATE 528 
DFHTC CTYPE=STATUS 530 
error processing 

batch logical units (TCAM SNA) 470 
execution 330 
routines 361 

error processor source 339 
error processor vector table (EPVT) 367 
error processors — DFHSNEP 
TYPE=DEF3270 366 

error processors for INTLU — DFHSNEP 
TYPE=DEFILU 367 

error processors, user—written 371 
error recovery action 441 
error recovery procedures 265 
error status blocks 373 
error status elements 

DFHTEPT TYPE=PERMCODE/ERRCODE 343 
error status information 363 
error-processor selection 330 
errors and actions unique to TCAM, 

DFHTEP 476 
ESB structure 368 
ESBS operand 368 
ESE (see error status elements) 

ESE information 334 
estimation process, performance 

application program definition 609 
system definition 609 
examples of terminal control table 
preparation 629 

exec interface program (see DFHSG 
PRO GRAM=E IP) 46 
EXEC operand 203 

execution (command level) diagnostic 
facility (EDF) 192,624 
execution speeds 568 

EXP, command (EXEC) language translator 
program 

(see DFHSG PROGRAM=EXP) 47 
extended local LDC list 247 
extended local LDC list, DFHTCT TYPE-LDC 
logical device codes (LDCs) 244 
PGESTAT operand 248 
EXTENT operand 133 
extents 

journal 394 
maximum number of 133 
EXTRA operand 82 
extrapartition data sets 82 
extrapartition destinations — DFHDCT 
TYPE=EXTRA 

destination identification (DESTID) 103 
multiple extrapartition 
destinations 103 


factors in selecting buffer size 395 
FCP — file control program (see DFHSG 
PROGRAM=FCP) 48 
FCP operand 203 

FCT — file control table (see DFHFCT) 116 
FCT operand 204 
FDP operand 204 
FDUMP operand 162,169 
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FEATURE operand 

DFHSG PROGRAM=TCP 75 
DFHTCT TYPE=LINE 256 
DFHTCT TYPE=SDSCI 268 
DFHTCT TYPE=TERMINAL 283 
2260 display station 494 
field relocation 30 
FILABL operand 111 
file backout table 420 
file control program (see DFHSG 
PROGRAM=FCP) 48 

file control table (see DFHFCT1 116 

file management 116 

file service requests 123 

FILSERV operand 49 

FILSTAT operand 126 

find TCTTE 527 

first communication line entry 270 

first quiesce stage 183 

FIX operand 98,157 

FLDSEP operand 205 

FLDSTRT operand 205 

FLNNAME operand 270 

FMH processing 469 

FMT2260 operand 75 

FMT3270 operand 76 

FN operand 176,191 

forced pageout 190 

format description of TACLE DSECT 350 
FORMAT mode 493 
format of macro instructions 4 
format of records 130 
formatted dump program 
DFHPCT TYPE=ENTRY 169 
DFHPCT TYPE=INITIAL 162 
FDP operand, DFHSIT 204 
formatted 2260 screen 495 
frequency, user activity keypointing 436 
full warm restart 415 
FULLBUF mode 493 
functional groups 176,191 
functions performed by DFHTBP 418 
F2260 operand 203 


GAP — graphic attention program (see 
DFHSG PROGRAM=GAP) 51 
general entry and initialization 330 
general exit, DFHTEP 331 
general poll 257 

generalized message format, TCAM 481 
generate DDIR (DFHDLDBD) 

data base description block pBD) 
operand 320 
DBD operand 320 
SUFFIX operand 319 
TYPE=ENTRY operand 319 
TYPE=FINAL 320 
TYPE=INITIAL operand 319 
generate logical units 276 
generate PDIR (DFHDLPSB) 

MXSSASZ operand 318 
PSB operand 318 
RMTNAME operand 318 
segment search argument 318 
SUFFIX operand 318 
SYSIDNT operand 319 
TYPE=ENTRY operand 318 
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generate PDIR (DFHDLPSB) (continued) 
TYPE=FINAL operand 319 
TYPE=INITIAL operand 318 
GENPOLL=YES operand 257 
GMMSG operand 285 
GMTEXT operand 235 
GPBLKSZ operand 239 
GPNAME operand 240 
GPNTRMS operand 240 
GPSEQLU operand 240 
GPTCU operand 240 

graphic attention program (see DFHSG 
PROGRAM=GAP) 51 
GROUP operand 372 
GTYPE operand 238 


HANDLE ABEND command 381 
header of segmented record — DFHFCT 
TYPE=SEGHEAD 141 
HF operand 297 

High Performance Option (HPO) 118 
DFHFCT TYPE=ALTERNATE 118 
DFHOC TYPE=OPEN 544 
mixed mode files 118,135 
MODE operand 135,544 
SRBSVC operand 20 
VSAM ICIP 118 

high-level language support group (see 
DFHSG PROGRAM=HLL) 52 
high-level language trace 63 
HLL, high-level language support (see 
DFHSG PROGRAM=HLL) 52 
HLLTR operand 63 

host processor response and maximum 
loading 603 

derivation of input data 605 
example 605 

treatment of page—faults 607 
host processor utilization 553 

calculating background processor 
utilization 557 

calculating transaction processor 
utilizations 557 

defining transactions and transaction 
rates 555 

total processor utilization 558 
transaction execution times 556 
HPO — see High Performance Option 118 


I AD ADM I operand 13 7 
IADIII operand 137 
IALKFL operand 136 
IARLKP operand 136 

ICP — interval control program (see DFHSG 
PROGRAM=ICP) 53 
ICP operand 205 
ICV operand 205 
ICVR operand 206 
ICVS operand 206 
ICVSWT operand 215 
ICVTSD operand 206 
ID verification, 3740 
ANSWRBK=EXIDVER 503 
IDERROR operand 

DFHJC TYPE=CLOSE 400 
DFHJC TYPE=GET 403 


IDERROR operand (continued) 

DFHJC TYPE=OPEN 398 
IEFRH macro 469 
IIP operand 206 
IMS/VS control blocks 315 
in-flight tasks 433 
INAREAL operand 251 
INBFMH operand 170 
INBUFF operand 24 
INDAREA operand 126 
INDDEST operand 105 
INDDISP operand 141 
index buffers 125 
INDEX operand 

DFHDCT TYPE=INITIAL 101 
DFHFCT TYPE=ALTERNATE 120 
DFHFCT TYPE=DATASET 134 
DFHPCT TYPE=INITIAL 162 
DFHPPT TYPE=INITIAL 187 
index skip feature 133 
indexing 162 

indirect data destinations — DFHDCT 
TYPE=INDIRECT 104 
INDSIZE operand 126 
INDSKIP=YES operand 133 
initial input record 425 
initialization — DFHSG TYPE=INITIAL 
initiating transactions 499 
INITRL=YES operand 81 
input BSAM data set control name 257 
input processor, ATP 518 
INPUT status 296 
input user exit (XTCMIN) 483 
inquiry mode, 3735 501 

inter—region communication 
buffer size 237 
DFHSG PROGRAM=ISC 54 
DFHTCT TYPE=IRCBCH 242 
DL/I shared data base 
DFHSG PROGRAM=ISC 54 
IRBUFSZ operand 237 
IRCSTRT operand 217 
macro/operand checklist 674 
programs 54 
SVC 55 

intersystem communication 
DFHDCT TYPE=REMOTE 107 
DFHFCT TYPE=REMOTE 139 
DFHTCT TYPE=ISLINK 243 
DFHTST TYPE=REMOTE 307 
ISC operand 206 
journal records 408 
macro/operand checklist 674 
performance information 608.1 
program group (see DFHSG 
PROGRAM=ISC) 54 
session types 244 
TCT example 662 

interval control data recovery 432 
interval control program (see DFHSG 
PROGRAM—I CP) 53 
INTRA operand 8 3 

intrapartition destinations — DFHDCT 
TYPE=INTRA 105 

intrapartition queues, DAM/BDAM and 
VSAM 83 
INVADDR operand 

DFHTC CTYPE=CHECK 533 


13 
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INVADDR operand (continued) 
DFHTC CTYPE=LOCATE 528 
DFHTC CTYPE= STATUS 530 
INVID operand 

DFHTC CTYPE=CHECK 533 
DFHTC CTYPE=LOCATE 528 
DFHTC CTYPE-STATUS 530 
INVLDC operand 

DFHTC CTYPE=CHECK 533 
DFHTC CTYPE=STATUS 530 
INVREQ operand 

DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 398 
DFHTC CTYPE=CHECK 533 
DFHTC CTYPE—STATUS 530 
IOCP operand 217 
IOERROR operand 

DFHJC TYPE=CLOSE 400 
DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 398 
DFHKP TYPE=CHECK 436 
DFHKP TYPE=RTBOCTL 434 
DFHKP TYPE=RTBODATA 435 
IOSIZE operand 127 
IOWORK operand 134 
IPL status, system/7 296 

XPL system/7 

BSC lines 491 
start/stop lines 491 
write transaction 491 
IRBUFSZ operand 237 
IRCSTRT operand 217 
XRCSVC operand 55 
ISADSCN operand 257 
ISAM reference set 590 
ISC operand 206 
ISC, intersystem communication 
program group (see DFHSG 
PROGRAM=ISC) 54 
issue VTAM indicator 527 


JCP operand 206 

JCP, journal control program (see DFHSG 
PROGRAM=JCP) 55 

JCT — journal control table (see 
DFHJCT) 148 
JCT operand 207 
JDEVICE operand 151 
JFILEID operand 

DFHJC TYPE-CLOSE 401 
DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 398 
DFHJCT TYPE=ENTRY 149 
DFHPCT TYPE=ENTRY 170 
logical units 463 
JID operand 120,127 
job control for sample DFHTEP 
generation 335 
JOBNAME operand 16 
journal 

devices 394 
extents 394 

journal control program (see DFHSG 
PROGRAM=JCP) 55 
journal control table 

additional journal options 396 
buffer size 394 


journal control table (continued) 
journal devices 394 
journal control table (see DFHJCT) 148 
journal entries in JCT 148 
journal file identification 127,149 
journal function and module 
identifications 406 
journal management 393 

application programming 397 
automatic journaling 394 
automatic logging 394 
emergency restart 394 
journal control table 394 
layout and contents of journal 
records 404 
journal records 394 
journaled data 409 
journaling options 149 
journaling requests 128 
journaling, automatic 
JOUROPT operand 149 
JREQ operand 120,128 
JTYPE operand 149 


KCP — task control program (see DFHSG 
PROGRAM=KCP) 58 
KCP operand 207 
key length 

logical 128 
maximum 144 
physical 124 
keyboard lock feature 76 
keyfield 131 
KEYLEN operand 

DFHFCT TYPE=DATASET 128 
DFHFCT TYPE=REMOTE 139 
DFHFCT TYPE=SHRCTL 144 
keypoint program (see DFHSG 
PRO GRAM=K PP) 59 

keypoint records 436 
keypointing 

abnormal termination 199 
activity 60 

KPP — keypoint program (see DFHSG 
PROGRAM—KPP) 59 
KPP operand 207 


LANG operand 

DFHSG PROGRAMMEXP 47 
DFHSG PROGRAM=HLL 52 
DFHSG PRQGRAM—PCP 63 
last segment set — DFHFCT 
TYPE=SEGLAST 142 
LASTID operand 297 
LASTTRM operand 

DFHTC CTYPE=CHECK 533 
DFHTC CTYPE==LOCATE 528 
DFHTC CTYPE=STATUS 530 
DFHTCT TYPE=ISLINK 243 
DFHTCT TYPE=TERMINAL 275 
layout and contents of journal records 404 
journal function and module 
identifications 406 
journaled data 409 
system prefix 407 
user prefix 409 
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LDC=YES operand 530 
LDCS 

DFHTCT TYPE=LDC 244 
DFHTCT TYPE=LDCLIST 249 
extended local list 247 
extended local list for 3770/3790 
BATCHDI 662 
LDC operand 

DFHTC CTYP E=L O CAT E 528 
DFHTCT TYPE=LDC 246 
DFHTCT TYPE=TERMINAL 285 
DFHTLT TYPE=INITXAL 303 
3770 batch TCT example 
LEAVE operand 401 
LENGTH operand 108 
LERBADR operand 266 
line 

addressing 499 
connection 269 
error recording block 266 
features 240 

group types — DFHTCT TYPE=GPENTRY 237 
input/output area (LIOA) 484 
locking, TCAM 478 
macro (BTAM/TCAM) 250 
permanent lock 478 
pool restrictions, TCAM 478 
pool specifications, TCAM 477 
SWITCH operand 269 
temporary lock 478 
line pool specifications 
POOL feature 477 
restrictions 478 
LINELST operand 240,269 
LINFEAT operand 240 
LININL operand 240 

LINSTAT= # OUT OF SERVICE 1 operand 257 
LISTADR operand 257,543 

local LDC list — DFHTCT TYPE=LDCLIST 249 
LOCAL operand 247 
local video unit 286 
lock feature 499 
lock option 256 
LOCKF=YES operand 76 
LOG operand 120,129 
logic flow, TCAM 472 
logical device codes (LDCs) 244,249 
logical device codes (see LDCs) 286 
logical key length 128 
logical record length 129 
logical record presentation 76,170 
logical unit I/O error handling 
(DFHZ NAC/DFHZNEP) 458 

logical unit of work 418 
logical units 

DFHZNAC action flags 681 
generate 276 

node error program 361,458 
TCT examples 653 
VTAMDEV operand 79 

logically recoverable destinations 106 

LOGMODE operand 286 

LOGREC operand 76,170 

LPLEN operand 286 

LRECL operand 129,140 

LVUNIT operand 286 


MACRF operand 270 

major access methods, storage requirements 
BDAM reference set 590 
BTAM reference set 588 
DL/I reference set 590 
ISAM reference set 590 
VSAM reference set 589 
VTAM reference set 586 
MAPALGN operand 33 
MAPHC operand 33 

mapping individual records and entire 
chains 465 
mapset suffixes 188 
MAP3270 operand 33 
master index 133 

master terminal program (see DFHSG 
PRO GRAM=MTP) 61 
MAXERRS operand 342 
maximum 

buffer size 395 
key length 144 

number of active asynchronous tasks 201 
number of active tasks 199 
number of extents 133 
MAXTIDS operand 342 
MCP operand 207 
message 

cache 425,457 

control program, TCAM 488 

control programs 

TCAM SNA examples 703 
DEST operand 477 
format, TCAM 481 
handler, TCAM 470 
input area length 251 
integrity 179 
logging 455 
option groups 178,455 
protection 179 
protection processing 455 
recovery 418,454 
recovery and emergency restart 
message cache 454 

node abnormal condition program 454 
system log 454 

recovery and resynchronization 422 
routing, TCAM 477 
switching 302,466 
table 419 

MESSAGE operand 298,299 

message option group 171 

message—originated transactions 423 

minimum buffer size 395 

mixed mode files (VSAM ICIP) 135 

MOD operand 16 

mode of communication, BSC 271 
MODE operand 

DFHFCT TYPE=DATASET 135 
DFHOC TYPE=OPEN 544 
DFHTCT TYPE=SDSCI 271 
model-dependent data stream 495 
MODELST operand 269 
modes of compatibility, 2260 493 

modifying terminal control table 

changing status of logical unit 527 
checking outcome of operation 527 
issue VTAM indicator 527 
scanning terminal control table 527 
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modifying terminal control table (continued) node error table header 373 


terminal locate function, DFHTC 
CTYPE=LOCATE 527 
MODNAME operand 111,236 
module load sequence — DFHNLT 
TYPE= ENTRY 156 
MODULE operand 157 

modules generated by system generation 
macros 665 
MONDLY operand 269 
motor—on optional feature 269 
MSGCLAS operand 21 
MSGJRNL operand 170,463 
MSGLVL operand 21,207 
MSGPOPT operand 179 
MSGPREQ operand 179,455 
MSTIND=YES operand 133 

MTP — master terminal program (see DFHSG 
PROGRAM=MTP) 61 

multiple extrapartition destinations 103 
multiple ISAM data sets 138 
multiple track search 132 
multiprocessor recovery procedures 
BTAM 438 

channel reconfiguration hardware 
(CRH) 438 
TCAM 440 
VTAM 438 

MXSSASZ operand 318 
MXT operand 207 
M32 operand 207 


NAME operand 366,367 
NAMFORM=DEC operand 223 
NEBNAME operand 368 
NEBS operand 368 
negative poll delay 258 
NEPCLAS operand 171,370 
NEPNAME operand 371 
NETNAME operand 

DFHSNEP TYPE=INITIAL 366 
DFHTCT TYPE^ISLINK 244 
DFHTCT TYPE=TERMINAL 287 
network component pathlengths 567 
network name 244,287 
new—line symbol (NL) 498 

NLT — nucleus load table (see DFHNLT) 152 

NLT operand 208 

node abnormal condition program 

logical unit I/O error handling 458 
node error program 361 
VTAM message recovery 454 
node error blocks 373 
node error program 361 
DFHZNEPI macros 369 
error messages and action flags 681 
interface module, DFHZNEPI 369 
node abnormal condition program 361 
sample 361 

system sense codes received 698 
terminal control program (VTAM 
portion) 361 
user-written 369 
VTAM error actions 681 
when abnormal condition occurs 361 
3270 unavailable printer 374 
node error table 363 
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node initialization block (NIB) 450 
non-compatible interfaces 6 
non-conversational transactions 591 
non-message-originated transactions 423 
non—purgeable task 353 
non—VTAM error actions 681 
noncatastrophic failures 458 
nonprotected tasks 455 

nonresident extrapartition data sets 112 
nonsequential disk extents 40,216 
NORESP operand 

DFHJC TYPE=CLOSE 401 
DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 398 
DFHKP TYPE=CHECK 436 
DFHKP TYPE=RTBOCTL 434 
DFHKP TYPE=RTBODATA 435 
DFHTC CTYPE=CHECK 533 
DFHTC CTYPE=LOCATE 529 
DFHTC CTYPE=STATUS 530 
NOTE operand 57 
NOTOPEN operand 403 
NPDELAY operand 258 
NRECDS operand 133 
NSD operand 40,216 

nucleus load table (see DFHNLT) 152 
nucleus module name 157 
number of concurrent tasks 291 
number of retries 269 
number of terminals 240 


OBJDSID operand 137 
object data set 137 
object-compatible interfaces 

control block and area prefix fields 6 
OCP — dynamic open/close program (see 
DFHSG PROGRAM—OCP) 62 
online terminal test facility 270 
online test facility 266 
OPCLASS operand 223 
OPEN operand 

DFHDCT TYPE=EXTRA 104 
DFHFCT TYPE=DATASET 130 
DFHJCT TYPE=ENTRY 150 
opening data sets — DFHOC TYPE=0PEN 541 
opening journal data sets — DFHJC 
TYPE=OPEN 397 
operating system 
abend code 225 
abends 89,312 
storage requirements 585 
operating system and major access method 
storage requirements 569 
operator 

identification code 287 
priority 287 
security key 287 
OPERID operand 287 
OPERPRI operand 287 
OPERSEC operand 287 
OPIDENT operand 222 
OPNAME operand 222 
OPNDLIM operand 235 
OPPRTY operand 223 
OPSECUR operand 58 
OPSYS operand 20 
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OPTCD operand 271,477 

OPTGRP operand 171 

optional common subroutines 364 

optional error processor for INTLU 365 

optional error processors for 3270 364 

OPTIONS operand 336,343 

OS/VS 

abend codes 226 
JCL options 21 
OSADSCN operand 259 
OSCOR 

definition 580 
operand 218 

OUT OF SERVICE status 297 
outboard formatting 31 
OUTBUFF operand 24 
output 

BSAM data set control name 259 
processor (CWTR) 519 
user exit (XTCMOUlj 484 
OUTQ ope rand 261 
overflow records, cylinder 


page alignment 98,157 
page faults 607 
page fixing 99,157 
page-chaining command 208 
page-copy command 208 
page-fix SVC 19 
page-purge command 208 
page—retrieval command 208 
PAGEIN operand 158 
PAGEOUT operand 99,158 
paging activity 248,289 
PAGING operand 34 
parity check 132 
partition abend recovery 441 
PASSWD operand 120,130 
PASSWRD operand 222 
PBP operand 208 
PCBs (see program communication 
blocks) 316 

PCP — program control program (see DFHSG 
PROGRAM—PCP) 62 
PCP operand 208 

PCT — program control table (see 
DFHPCT) 161 
PCT operand 208 
PDIR operand 219 
performance aspects 551 
permanent line lock 478 
PGCHAIN operand 208 
PGCOPY operand 208 
PGESIZE operand 248,287 
PGESTAT operand 248,289 
PGMERID operand 21 
PGMLANG operand 188 
PGMSTAT operand 188 
PGRET operand 208 
PGSIZE operand 209 
phonetic codes and keys 

DFHBIF TYPE=PHONETIC 547 
DFHPHN 547 
DFHSG PROGRAM=BFP 547 
physical I/Os and device service times 
estimating 617 


physical I/Os, calculate disk device 
service times 599 
physical key length 124 
physically recoverable destinations 105 
pipeline session 76,289 
PIPELN operand 76,289 
PISCHD operand 220 
PL/I programs 

LANG operand 47,52 
PGMLANG operand 188 
PLI operand 209 
PLI/PLI—SHARE operand 48 
PLILIB operand 48,53 
PLISHRE operand 220 

PLT — program list table (see DFHPLT) 182 
PLTPI operand 209 
PLTSD operand 209 
PL1/PLI operand 53 
poll list, 3600 BSC 505 
polling position 290 
POLLPOS operand 290 
POOL feature, TCAM 477 
pool of common TCTTEs 472 
pool of TCTLEs 261 
POOL=YES operand 261 
POOLADR operand 259 
POOLCNT operand 261 
positioning information 57 
post-initialization phase 182 
post-initialization processing 418 
PPT — processing program table (see 
DFHPPT) 186 
PPT operand 210 

prefix creation, user journals 58 

PREFIX operand 22 

PRGDLAY=hhmm operand 34 

primary printer 290 

primed storage allocation 175 

print line length 286 

PRINT operand 

DFHSG TYPE=INITIAL 17 
DFHSIT 210 

DFHTEPM TYPE=INITIAL 337 
printer authorization matrix 211 
printer—adapter feature 283 
PRINTTO operand 290 
PRIORTY operand 22 
PRIVATE operand 171 
PRMSIZE operand 175 
problem determination, emergency 
restart 417 

process control information field 
(PCI) 259,291 
process queue, TCAM 262 

processing program table (see DFHPPT) 186 
processing programs — DFHPPT 
TYPE=ENTRY 187 

processing transaction backout data 433 
active tasks 433 
DFHKP macro instructions 434 
in-flight tasks 433 
processor console as terminal, TCT 
example 648 
processor utilization 
how to calculate 610 

transaction processor utilization 613 
transaction timings 611 
PROCNMS operand 22 
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program check 

error recovery action 441 
partition abend recovery 441 
recovery 441 

program checks in application 
Programs 89,312 

program communication blocks (PCBs) 316 
program control program (see DFHSG 
PROGRAM=PCP) 62 

program control table (see DFHPCT) 161 
program error program (DFHPEP) 383 
program generation summary 

modules generated by system generation 
macros 665 

program isolation scheduling 220 
program list table (see DFHPLT) 182 
program load request 188 
program load sequence — DFHALT 
TYPE=ENTRY 97 
PROGRAM operand 

DFHALT TYPE=ENTRY 98 
DFHPCT TYPE=ENTRY 164 
DFHPLT TYPE=ENTRY 184 
DFHPPT TYPE=ENTRY 187 
DFHSRT TYPE=SYSTEM/USER 225 
program specification blocks (PSBs) 315 
program storage 578 
PROGRAM=ATP operand 24 
PROGRAM-BFP operand 25 
PROGRAMfBMS operand 27 
PROGRAM=CSA operand 36 
PROGRAM=CSD operand 37 
PROGRAM=CSO operand 39 
PROGRAM=CSS operand 41 
PROGRAM=CSU operand 42 
PROGRAM=DBP operand 43 
PROGRAM=DCP operand 44 
PROGRAM=DFHDELIM operand 
DFHPLT TYPE=ENTRY 18 4 
PROGRAM=DIP operand 45 
PROGRAM—DLZSTPO 0 operand 
DFHPLT TYPE=ENTRY 185 
PROGRAMMEIP operand 46 
PROGRAM=EXP operand 4 7 
PROGRAM—FCP operand 49 
PROGRAM=GAP operand 51 
PROGRAM=HLL operand 52 
PROGRAM=ICP operand 53 
PROGRAM=ISC operand 55 
PROGRAM=JCP operand 56 
PROGRAM=KCP operand 58 
PROGRAM=KPP operand 60 
PROGRAM=MTP operand 61 
PROGRAM=OCP operand 62 
IJROGRAM=PCP operand 63 
PROGRAM=RSP operand 64 
PROGRAM=SCP operand 65 
PROGRAtfc=SRP operand 6 6 
PROGRAM=TBP operand 67 
PROGRAM=TCP operand 69 
PROGRAM=TDP operand 82 
PROGRAM=TRP operand 84 
PROGRAM=TSP operand 86 
PROTECT operand 158.1 
protected tasks 455 
protocol management 468 
PSB directory (PDIR) list 317 
PSB operand 220,318 


PSB pool size 220 
PSBPL operand 220 
PSBs (see program specification 
blocks) 315 
PUNSOL operand 77 
purge delay time interval 35 


queue considerations, TCAM 479 
queue locks, TCAM 479 
QUEUEID operand 262 


RAMAX operand 235,452 
RAMIN operand 235 
RAPOOL operand 235 
RAQ=YES operand 77 
RATIMES operand 236,452 
RDYMSG operand 259 
read journal data sets 409 
backward 411 

DFHJC TYPE= (GETJCA,OPEN) 415 
during CICS/VS execution 410 
forward 412 
offline 410 

read timeout feature 172 
read transaction backout control 
record 434 

read transaction backout data 434 
read—ahead-queuing 7 7 
ready message, 7770 259 

real or reference set storage 
requirements 585 

CICS/VS reference set 591 
major access methods 586 
operating system 585 
RECEIVE status 296 
RECFM operand 271 
RECFORM operand 

DFHDCT TYPE=SDS Cl 109 
DFHFCT TY PE=ALT ERNATE 120 
DFHFCT TYPE=DATASET 130 
record 

format 130,271 
identification field 136 
length 110 

logical record length 129 
variable length 110 
RECOVER operand 65 
recoverable destinations 82 
recovery/restart 323 

CICS/VS dynamic transaction 
backout 90,312 

CICS/VS emergency restart 90,313 
CICS/VS warm restart 89,312 
emergency restart 417 
journal management 393 
multiprocessor recovery procedures 437 
node error program 361 
operating system abends 89,312 
program check 441 
program checks in application 
programs 89,312 
system abend 389 
system generation 87 
telecommunications errors 89,311 
terminal error program 325 
transaction abend 377 
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recovery/restart (continued) 
transaction restart 312 
warm restart 415 
RECSIZE operand 109 
reference set tables 592 
reference set, estimating 614 
REGION operand 23 
relative addressing 131 
relative line number 255 
relative power factors 557 
release logical unit 290 
RELOAD operand 188 
RELREQ exit-routine 451 
RELREQ operand 290 
RELTYPE operand 131 

remote files — DFHFCT TYPE=REMOTE 139 
remote temporary storage queues — DFHTST 
TYPE=REMOTE 307 

remote transient data destinations — 
DFHDCT TYPE=REMOTE 107 
replace error processors — DFHTEPM 
TYPE=ERRPROC 339 
request unit 290 

required entries in CICS/VS control tables 
destination control table 621 
DFHPCT TYPE=GROUP 176 
DFHPPT TYPE=GROUP 191 
processing program table 625 
program control table 622 
program control table (optional 
features) 624 
RES operand 189 
RESEND operand 64 

resend program (see DFHSG PROGRAM=RSP) 64 

reset transaction backout pointer 435 

RESIDNT operand 104 

resource limit 144 

RESP operand 236 

response type 236 

restart emergency restart 418 

RESTART operand 171 

restrictions on IMS/VS batch application 
programmer 320 
retrieve LDC information 527 
RETRY operand 269 
REUSE operand 106.1 
REWIND operand 110 
RKP operand 131 
RLR operand 211 
RMTNAME operand 

DFHDCT TYPE=REMOTE 108 
DFHDLPSB TYPE=ENTRY 318 
DFHFCT TYPE=REMOTE 140 
DFHPCT TYPE=ENTRY 172 
DFHTST TYPE=REMOTE 307 
rotational position sensing 139,600 
ROUTINE operand 226 
routing mechanism 363 
ROUTING operand 35,465 
RPFs (see relative power factors) 557 
RPG II programs 

LANG operand 47,52 
PGMLANG operand 188 
RPLs 451 

RPS=SVA operand 139 
RSCLMT operand 144 
RSDBLKS operand 61 


RSP — resend program (see DFHSG 
PROGRAM=RSP) 64 
RTIMOUT operand 172 
RUSIZE operand 290 
RVI (reverse interrupt) 252 


sample node error program 361 

common subroutine vector table 363 
compatibility with sample TEP 362 
components 362 
DFHSNEP TYPE=INITIAL 366 
error processing routines 361 
error processor vector table 363 
error processor vector table (EPVT) 367 
error processors — DFHSNEP 
TYPE=DEF3270 366 

error processors for INTLU — DFHSNEP 
TYPE=DEFILU 367 
error status information 363 
node error table 363,367 
optional common subroutines 364 
optional error processor for INTLU 365 
optional error processors for 3270 364 

routing mechanism 363 
sample node error table 367 
user—supplied error processors, DFHSNEP 
TYPE=ERRPROC 371 
sample TCAM SNA message control 
programs 703 

sample terminal error program 327 
common subroutines 331 
components 327 

default threshold count limits 344 
define terminal error blocks 

tables, DFHTEPT TYPE=PERMTID 343 
DFHTEP tables 341 
DFHTEPM TYPE=INITIAL 335 
DFHTEPT TYPE=PERMCODE/ERRCODE 343 
error processing execution 330 
error processor source 359 
error status element (ESEs) 328 
error—processor selection 330 
general entry and initialization 330 
general exit 331 
generate sample TEP module 335 
job control for sample DFHTEP 
generation 335 
messages 

action flag names 333 
DECB information 333 
DECB operand 333 
ESE information 334 
TACLE information 334 
overview 332 

replace error processors, DFHTEPM 
TYPE=ERRPROC 339 
tables 

default threshold count limits 346 
DFHTEPT macro examples 347 
DFHTEPT TYPE=BUCKET 346 
DFHTEPT TYPE=1NITIAL 342 
TEP default table 329 
TEP error table 328 
terminal error blocks 328 
terminal identification and error—code 
lookup 330 

TYPE=PERMCODE/ERRCODE operand 344 


Index 


743 



Page of SC33—0069—2, revised August 1978 by TNL SN33—6217 


sample terminal error program module 335 
DFHTEPM macro examples 340 
end of sample DFHTEP *— DFHTEPM 
TYPE-FINAL 340 
TYPE=FINAL operand 340 
scanning terminal control table 527 
scheduling 

program isolation 220 
segment intent 220 

SCP — storage control program (see DFHSG 
PROGRAM=SCP) 65 
SCP operand 211 
screen format, 2260 295 

screen sizes 

alternate 278 
default 283 

screen techniques, 2260 495 

SCRNSZE operand 163,172 
SCS operand 211 
SCTYKEY operand 223 
search argument type 138 
seek time 599 
SEGLENG operand 140,141 
segment characteristics 140 
segment indicator field 141 
segment intent scheduling 220 
segment length 140 

segment processing, OPTCD operand 477 
segment processing, TCAM 477 
segment search argument 318 
segment sets — DFHFCT TYPE=SEGSET 142 
segments of segmented record — DFHFCT 
TYPE=SEGDEF 140 
SEGNAME ope rand 140,143 
SEGSET operand 142 
selective transaction abend 389 
selector pen feature 284 
SEPASMB ope rand 101 
sequence of events, TCAM 472 
service request block SVC 20 
SERVREQ operand 119,122 
SESNUMB operand 243 
session types 

inter system contmuni cation 244 
logical units 275 
SESTYPE operand 275,291 
SETEOM macro 470 
short wait interval 215 
sign-on procedure 221 
sign-on table (see DFHSNT) 221 
single keystroke retrieval 35 
SIT — system initialization table (see 
DFHSIT) 195 
SIVOL=YES operand 398 
size of RPL pool 466 
SKR operand 212 
SKR3270 operand 35 
SMI operand 77 

SNA character string (SCS) 468 
SNT — sign-on table (see DFHSNT) 221 
source—compatible interfaces 6 
specific error conditions — DFHTEPT 
TYPE=BU CKET 346 
SPURGE operand 173 
SRBSVC operand 20 
SRCHM operand 131 
SRCHTYP operand 137 


SRP — system recovery program (see DFHSG 
PROGRAM= SRP) 66 
SRP operand 212 
SRT — system recovery table 
abend codes — DFHSRT 
TYPE=SYSTEM/USER 225 
SRT — system recovery table (see 
DFHSRT) 224 
STAGE2 operand 


DFHSG 

PROGRAM=ATP 

24 

DFHSG 

PROGRAM=BFP 

25 

DFHSG 

PROGRAM=CSD 

37 

DFHSG 

PROGRAM=C SO 

39 

DFHSG 

PROGRAM=CSS 

42 

DFHSG 

PROGRAM=C SU 

42 

DFHSG 

PROGRAM=DBP 

43 

DFHSG 

PROGRAM=DCP 

44 

DFHSG 

PROGRAM=D IP 

46 

DFHSG 

PROGRAM=EIP 

46 

DFHSG 

PROGRAM=EXP 

48 

DFHSG 

PROGRAM=GAP 

51 

DFHSG 

PROGRAM=HLL 

52 

DFHSG 

PROGRAM=ICP 

53 

DFHSG 

PROGRAM=JCP 

57 

DFHSG 

PROGRAM=K CP 

59 

DFHSG 

PROGRAM=KPP 

61 

DFHSG 

PROGRAM=MTP 

62 

DFHSG 

PROGRAM=OCP 

62 

DFHSG 

PROGRAM=RSP 

65 

DFHSG 

PROGRAM—S CP 

65 

DFHSG 

PROGRAM=SRP 

67 

DFHSG 

PROGRAM=TBP 

68 

DFHSG 

PROGRAM=TCP 

77 

DFHSG 

PROGRAM=TDP 

83 

DFHSG 

PROGRAM=TRP 

85 

DFHSG 

PROGRAM=TSP 

86 

DFHSG 

TYPE=INIT IAL 

17 


START operand 212 

start-of-message indicator (SMI) 498 
starter system library 11,18 
startup, TCAM 485 
STATERR operand 

DFHJC TYPE=CLOSE 401 
DFHJC TYPE=GET 403 
DFHJC TYPE=OPEN 399 
static CICS/VS area requirements 570 
CICS/VS modules 570 
CICS/VS table sizes 575 
static reference set 591 
station address 291 
station control feature 256 
STATUS operand 531 
STATUS=FIRST operand 20 
STN2980 operand 291 
storage control program (see DFHSG 
PRO GRAM=S CP) 65 
storage cushion 

SCS operand 212 
size 212 
storage area 579 
storage recovery 65 
storage violation dump 213 
strings 132 
strings (GET only) 136 
STRNO operand - 120,132,144 
STRNOG operand 120,136 
structure of this manual 3 
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SUFFIX operand 

DFHALT TYPE=INITIAL 97 
DFHDCT TYPE=INITIAL 102 
DFHDCT TYPE=SDSCI 110 
DFHDLDBD TYPE=INITIAL 319 
DFHDLPSB TYPE=INITIAL 318 
DFHFCT TYPE=INITIAL 118 
DFHJCT TYPE=INITIAL 148 
DFHNLT TYPE=INITIAL 156 
DFHPCT TYPE=INITIAL 163 
DFHPLT TYPE=INITIAL 184 
DFHPPT TYPE=INITIAL 187 
DFHSG PROGRAM=BFP 26 
DFHSG PROGRAM=BMS 35 
DFHSG PROGRAM=CSA 36 
DFHSG PROGRAM=DBP 43 
DFHSG PROGRAM=DCP 44 
DFHSG PROGRAM=DIP 46 
DFHSG PROGRAM=EXP 48 
DFHSG PROGRAM=FCP 50 
DFHSG PROGRAM=ICP 54 
DFHSG PROGRAM=ISC 55 
DFHSG PROGRAM=JCP 58 
DFHSG PROGRAM=KCP 59 
DFHSG PROGRAM=KPP 61 
DFHSG PROGRAM=PCP 64 
DFHSG PROGRAM=SCP 66 
DFHSG PROGRAM=SRP 67 
DFHSG PROGRAM=TBP 68 
DFHSG PROGRAM=TCP 78 
DFHSG PROGRAM=TDP 83 
DFHSG PROGRAM=TRP 85 
DFHSG PROGRAM=TSP 86.1 
DFHSIT 213 

DFHSRT TYPE=INITIAL 225 
DFHTCT TYPE=INITIAL 236 
DFHTLT TYPE=INITIAL 303 
DFHTST TYPE=INITIAL 306 
DFHXLT TYPE=INITIAL 309 
superset ISAM logic module — DFHFCT 
TYPE=LOGICMOD 

multiple ISAM data sets 138 
SVC operand 41 
SVD operand 213 
SWITCH operand 269 
switched BSC temporary text delay 
(TTD) 357 

switched line disconnected bit 353 
switched-line pools 250 
switching dump data sets — DFHOC 
TYPE=SWITCH 545 
SYMBADR operand 545 
SYNAD operand 272 
syntax notation 3 
SYSIDNT operand 

DFHDCT TYPE=REMOTE 108 
DFHDLPSB TYPE=ENTRY 319 
DFHFCT TYPE=REMOTE 139 
DFHPCT TYPE=ENTRY 173 
DFHTCT TYPE=ISLINK 244 
DFHTST TYPE=REMOTE 307 
system abend code 225 

system abend, abnormal termination 389 
system generation 13 

ATP -— asynchronous transaction 
processing program 23 
BFP -— built-in functions program 24 
BMS — basic mapping support program 26 


system generation (continued) 

CSA — common system area 35 
CSD — control system dummy group 36.1 
CSO — control system operational 
group 37 

CSS — control system service group 41 
CSU — control system utility group 42 
DBP — dynamic transaction backout 
program 42 

DCP — dump control program 44 
DFHSG macros 13 
DFHSG PROGRAM=ATP 23 
DFHSG PROGRAM=BFP 24 
DFHSG PROGRAM=BMS 26 
DFHSG PROGRAM=CSA 35 
DFHSG PROGRAM=CSD 36.1 
DFHSG PROGRAM=CSO 37 
DFHSG PROGRAM=CSS 41 
DFHSG PROGRAM=C SU 42 
DFHSG PROGRAM=DBP 42 
DFHSG PROGRAM=DCP 44 
DFHSG PROGRAM=DIP 45 
DFHSG PROGRAM=EIP 46 
DFHSG PROGRAM=EXP 47 
DFHSG PROGRAM=FCP 48 
DFHSG PROGRAM=GAP 51 
DFHSG PROGRAM=HLL 52 
DFHSG PROGRAM=ICP 53 
DFHSG PROGRAM=ISC 54 
DFHSG PROGRAM=JCP 55 
DFHSG PROGRAM=KCP 58 
DFHSG PROGRAM=KPP 59 
DFHSG PROGRAM=MTP 61 
DFHSG PROGRAM=OCP 6 2 
DFHSG PROGRAM=PCP 62 
DFHSG PROGRAM=RSP 64 
DFHSG PROGRAM=SCP 65 
DFHSG PROGRAM=SRP 66 
DFHSG PROGRAM=TBP 67 
DFHSG PROGRAM=TCP 68 
DFHSG PROGRAM=TDP 81 
DFHSG PROGRAM=TRP 84 
DFHSG PROGRAM=TSP 85 
DIP — batch data interchange 
program 45 
DL/I 91 

EIP — exec interface program 46 
EXP, command (EXEC) language translator 
program 47 

FCP — file control program 48 
GAP — graphic attention program 51 
HLL — high-level language support 
group 52 

ICP — interval control program 53 
initialization — DFHSG TYPE=INITIAL 13 
intersystem communication (see DFHSG 
PROGRAM=ISC) 54 

JCP — journal control program 55 

KCP — task control program 58 

KPP — keypoint program 59 

management programs, list of 12 

modules generated 13,665 

MTP — master terminal program 61 

OCP - dynamic open/close program 62 

PCP — program control program 62 

recovery/restart 87 

RSP — resend program 64 

SCP — storage control program 65 
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system generation (continued) 
service programs, list of 12 
SRP — system recovery program 66 
TBP — transaction backout program 67 
TCP — terminal control program 68 
TDP — transient data control 
program 81 

termination — DFHSG TYPE=FINAL 87 
TRP — trace control program 83 
TSP — temporary storage control 
program 85 

TYPE=FINAL operand 87 
utility program 12 
system initialization overlays 

system initialization program 523 
system initialization processing 182 
system initialization program 
overlays 523 

system initialization table (see 
DFHSIT) 195 

system LDC table, DFHTCT TYPE=LDC 
logical device codes (LDCs) 244 
PGESTAT operand 248 

system LDC table, extended local LDC list 
PFHTCT TYPE=LDC) 244 
system log 454 
system log data set 418 
system logical unit number 240 
system prefix 407 

system recovery program (see DFHSG 
PROGRAM=SRP) 66 

system recovery table (see DFHSRT) 224 

system restart data set 418 

system sense codes received by DFHZNAC 698 

system stall purge indicator 173 

system/3, TcT example 643 

system/7 

IPL status 296 
special features 268 
SYSWAIT operand 150 


tab feature 78 
tab feature, 2260 496 

TAB operand 78 
table preparation 

ALT — application load table 97 
DCT — destination control table 100 
DL/I 315 

FCT — file control table 116 
JCT — journal control table 148 
NLT — nucleus load table 152 
PCT — program control table 161 
PLT — program list table 182 
PPT — processing program table 186 
recovery/restart 311 

SIT — system initialization table 195 
SNT — sign—on table 221 
SRT — system recovery table 224 
TCT — terminal control table 228 
TLT — terminal list table 302 
TST — temporary storage table 305 
XLT — transaction list table 308 
2260 compatibility for 3270 494 

TAB2980 operand 291 
TACLE 348 

action and information bits 352 
action bits 352 


TACLE (continued) 

address contents 348 
DSECT, format description 350 
information 334 

task attach user exit (XATTACH) 483 
task control program (see DFHSG 
PRO GRAM=KCP) 58 
TASKNO operand 291 
TASKREQ operand 164,309 
•tasks, maximum number per transaction 
class (CMXT) 201 
TBLFIX operand 78 

TBP — transaction backout program (see 
DFHSG PROGRAM=TBP) 67 
TCAM 467 

abend/r es tart 486 

application program interface 470 

communication control byte (s) 480 

data format 472 

DD card correlation 471 

default actions taken by DFHTACP 480 

devices 480 

generalized message format 481 

input event 483 

input process queue 471 

input user exit (XTCMIN) 483 

line input/output area (LIOA) 484 

line locking 478 

line pool restrictions 478 

line pool specifications 477 

logic flow 472 

message control program 488 

message control program (MCP) 470,480 

message handler 470 

message routing 477 

multiprocessor recovery procedures 440 

OPTCD operand 477 

output event 484 

output process queue 261 

output user exit (XTCMOUT) 484 

permanent line lock 478 

POOL feature 261,477 

pool of common TCTTEs 472 

process queue 262 

queue considerations 479 

queue locks 479 

segment processing 477 

sequence of events 472 

startup 485 

task attach user exit (XATTACH) 483 
TCT example 651 
temporary line lock 478 
terminal entries 471 
terminal error program 476 
terminal errors 

terminal abnormal condition 
program 325 

terminal control program 325 
terminal error program 325 
termination 486 
TPROCESS block 470 
unsolicited input 479 
user exits 483 
work area 484 
work unit 271 
XATTACH 483 
2260 482 

3270 482 
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TCAM SNA 468 

batch processing 470 
communication control byte (s) 468 

device message handler (DMH) 468 
device message handler control 468.1 
devices 262 
error processing 470 
error processing for batch logical 
units 470 
FMH processing 469 
IEFRH macro 469 
MCP examples 703 
protocol management 468 
SETEOM macro 470 
SNA character string (SCS) 468 
TCAMFET=SNA operand 262,468 
transaction control 469 
with CICS/OS/VS 468 
TCAMFET= SNA operand 262,468 
TCAMSIP=YES operand 41 
TCAPCARO field 389 
TCLASS operand 173 
TCM3 27 0=YES operand 81 

TCP — terminal control program (see DFHSG 
PROGR AM=TC P) 68 

TCP operand 213 

TCT — terminal control table (see 
DFHTCT) 228 
TCT operand 213 
TCTUA operand 20 
TCTUAL operand 259,291 
TDP operand 213 

TDP, transient data control program (see 
DFHSG PROGRAM=TDP) 81 
TEBs (see terminal error blocks) 328 
telecommunications errors 89,311 
teletypewriter (WTC only) 

disconnect message — DFHTCT 
TYPE=TLXMSG 298 
error conditions 358 
station identification — DFHTCT 
TYPE=TLXID 297 
TCT example 637 

teletypewriter exchange terminal (CPT- 
TWX) , TCT example 636 
temporary line lock 478 
temporary storage 
ageing limit 306 
backout 422 
dataids 306 
emergency restart 432 
message cache 454 
recovery 422 
table (see DFHTST) 305 
temporary storage control program (see 
DFHSG PROGRAM=TSP) 85 
TEP default table 329 
TEP error table 328 
TERM operand 529,532 

terminal abnormal condition line entry 
(TACLE) 326 

terminal address, BTAM 293 
terminal control program (see DFHSG 
PROGRAM=TCP) 68 * 

terminal control program (VTAM 
portion) 361 

terminal control table (see DFHTCT) 228 
terminal control table line entry 250 


terminal control table terminal entry 
(TCTTE) 272 

terminal control table user area 242 
terminal control, DFHTC macros 462 
terminal entries, TCAM 471 
terminal error blocks 328 
terminal error program 325 
CICS/VS components 325 
error messages and codes 677 
error messages and default actions 677 
errors and actions unique to TCAM 476 
non—VTAM error actions 681 
switched BSC temporary text delay 
(TTD) 357 
TCAM 476 

teletypewriter (WTC only) 358 

when abnormal condition occurs 325 

2740 model 2 358 

3270 locked buffer 360 

3270 unavailable printer 359 

3275 dialed 30—second timeout 360 

3600 BSC 360 

7770 32—second timeout 357 
terminal error purge indicator 174 
terminal group type 238 
terminal identification 241 
terminal identification and error—code 
lookup 330 

terminal input area length 240,241 
terminal input/output area length 291 
terminal list table (see DFHTLT) 302 
terminal locate function, DFHTC 
CTYPE=LOCATE 527 
terminal model number 241,260 
terminal operators — DFHSNT 
TYPE=ENTRY 222 

terminal scan delay interval 206 
terminal status 295 

terminal types — DFHTCT TYPE=TERMINAL 272 
termination, system generation 87 
termination, TCAM 486 
TERMTST operand 270 

test response to CTYPE requests, DFHTC 
CTYPE=CHECK 532 

test transaction backout response 435 

text—read errors 265 

text—write errors 265 

TIME operand 345,368 

TIOAL operand 291 

TIOTYPE operand 174 

TLT, terminal list table (see DFHTLT) 302 
TLXID operand 297 
total processor utilization 558 
TPMARK=NO operand 111 
TPP operand 213 
TPROCESS block 470 
TPURGE operand 174 
trace control program (see DFHSG 
PROGRAM=TRP) 84 
trace table alignment 159 
trace table entries 
track search, SRCHM operand 132 
transaction 

automatic initiation (ATI) 71,463 
class 173 

class, logical units 459 
code 

TRANSID operand 292,309 
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transaction (continued) 

control information — DFHPCT 
TYPE=ENTRY 163 
control, TCAM SNA 469 
description options — DFHPCT 
TYPE=OPTGRP 178 
execution times 556 
I/O processing 174 
identification 

TRANSID operand 165 
options 462 
priority 175 
restart facility 171,386 
security key 174 
status 17 5 
TWASIZE operand 175 
types 

BASE 555 
ECHO 555 

work area size 175 
transaction abend 377 

abnormal termination 378 
creating task abend exit 382 
DFHPC TYPE=SETXIT macro 381 
HANDLE ABEND command 381 
program error program (DFHPEP) 383 
user exits in DFHDBP 384 
transaction backout 418 

committed output message 423 
data base backout 421 
data written to system log 423 
default data base backout 421 
DL/I backout 426 
DL/I backout table 420 
DL/I error—exit 431 
file backout table 420 
file—error-exit 430 
functions performed 418 
initial input record 425 
initialization 419 

initialization/termination exit 428 
input—exit 429 
logical unit of work 418 
message backout table 419 
message cache 425 
message recovery 418 
message recovery and 
re synchroniz ation 422 
message—originated transactions 423 
non—message-originated transactions 423 
program 418 

program (see DFHSG PROGRAM=TBP) 67 
table 419 

temporary storage backout 422 
temporary storage recovery 422 
transient data recovery 425 
user input exit 421 
user—written exits 427 
transaction control information — DFHPCT 
TYPE=ENTRY 

transaction status 175 
transaction list table (see DFHXLT) 308 
transaction processor utilizations 557 
TRANSACTION status 295 
transaction-class error routine 459 
transaction-class error—handling 
routine 3 70 
TRANSCEIVE status 296 


TRANSEC operand 174 
TRANSID operand 

DFHDCT TYPE=INTRA 107 
DFHPCT TYPE=ENTRY 165 
DFHTCT TYPE=TERMINAL 292 
DFHXLT TYPE—ENTRY 309 
transient data control program (see DFHSG 
PROGRAM=TDP) 81 
transient data recovery 82,425 
translate tables 78 
transmission code 255 
transmission control unit 240 
trigger level 100,107 
TRIGLEV operand 107 
TRMADDR operand 240,293 
TRMFEAT operand 241 
TRMIDNT operand 

DFHTCT TYPE=GPENTRY 241 
DFHTCT TYPE=ISLINK 244 
DFHTCT TYPE=TERMINAL 275 
DFHTEPT TYPE=PERMTID 34 3 
DFHTLT TYPE=ENRTY 304 
VTAM 466 

TRMINL operand 241 
TRMMODL operand 

DFHTCT TYPE=GPENTRY 241 
DFHTCT TYPE-LINE 260 
DFHTCT TYPE=TERMINAL 294 
TRMPOSN operand 242 
TRMPRTY operand 242,295 
TRMSTAT operand 

DFHTCT TYPE=GPENTRY 242 
DFHTCT TYPE=TERMINAL 295 
VTAM 463 

TRMSTAT= * OUT OF SERVICE # operand 244 

TRMTYPE operand 252,275 

TRMUAL operand 242 

TRNPRTY operand 175 

TRNSTAT operand 175 

TRNSUFX operand 102 

TRP — trace control program (see DFHSG 
PROGRAM=TRP) 84 
TRP operand 214 
TRT operand 214 
TSAGE operand 306 
TSEGIND operand 141 
TSMGSET operand 214 
TSP operand 214 

TSP, temporary storage control (see DFHSG 
PROGRAM=TSP) 85 
TST operand 214 

TST, temporary storage table (see 
DFHTST) 305 
TWASIZE operand 175 

TWASIZE, CICS/VS—supplied transactions 623 
type of journal data set 149 
type of segment indicator field 141 
TYPE=ALTERNATE operand 119 
TYPE =BUCKET operand 346 
TYPE=CHECK operand 435 
TYPE=CLOSE operand 400,545 
TYPE=CSECT/DSECT operand 198 
TYPE=DATASET operand, DFHFCT 121 
TYPE=DEFILU operand 367 
TYPE=DEF3270 operand 366 
TYPE=ENTRY operand 
DFHALT 98 
DFHDLDBD 319 
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TYPE=ENTRY operand (continued) 
DFHDLPSB 318 
DFHJCT 148 
DFHNLT 156 
DFHPCT 164 
DFHPLT 184 
DFHPPT 187 
DFHSNT 222 
DFHTLT 303 
DFHXLT 309 

TYPE=ERRPROC operand 340,371 
TYPE=EXTRA operand 103 
TYPE=GETB/GETF/NOTE/POINT operand 402 
TYPE=GPENTRY operand 238 
TYPE=«ROUP operand 176,191 
TYPE =INDACC operand 136 
TYPE=INDIRECT operand 104 
TYPE=INITIAL operand 


DIHALT 

97 

DFHDCT 

101 

DFHDLDBD 319 

DFHDLPSB 318 

DFHFCT 

118 

DFHJCT 

148 

DFHNLT 

156 

DFHPCT 

161 

DFHPLT 

184 

DFHPPT 

186 

DFHSG 14 

DFHSNEP 

366 

DFHSNT 

221 

DFHSRT 

225 

DFHTCT 

234 

DFHTEPM 

335 

DFHTEPT 

342 

DFHTLT 

303 

DFHTST 

306 

DFHXLT 

309 

TYPE=INTRA operand 


TYPE=IRCBCH operand 242 
TYPE=ISLINK operand 243 
TYPE=LDC operand 245 
TYPE=LDCLIST operand 249 
TYPE-LINE operand 251 
TYPE=LOGICMOD operand 139 
TYPE=OPEN operand 397,541 
TYPE=OPTGRP operand 179 
TYPE=PERMCODE/ERRCODE oper and 344 
TYPE=PERMTID operand 343 
TYPE=RECOVERY/ENTRY operand 306 
TYPE=REMOTE operand 
DFHDCT 107 
DFHFCT 139 
DFHTST 307 

TYPE=RTBOCTL operand 434 
TYPE=RTBODATA operand 435 
TYPE=RTBOEND operand 435 
TYPE=SDSCI operand 108,263 
TYPE=SEGDEF operand 140 
TYPE=SEGHEAD operand 141 
TYPE=SEGLAST operand 142 
TYPE=SEGSET operand 142 
TYPE=SHRCTL operand 143 
TYPE=SWITCH operand 545 
TYPE=SYSTEM/USER operand 225 
TYPE=TERMINAL operand 275 
TYPE=TLXID operand 297 
TYPE=TLXMSG operand 298 


TYPE—7770MSG operand 299 
TYPEFLE operand 110 


UCTRAN operand 78 
unsolicited input 77 
unsolicited input, TCAM 479 
uppercase translation 78,284 
UPRFX operand 58 
USAGE=MAP operand 190 
use count for BMS maps 191 
user activity keypointing 
frequency 436 
keypoint records 436 
transaction CSKP 436 
user exits 

asynchronous transaction processing 517 
CRDR exit routine 518 
CWTR exit routine 519 
CICS/VS management programs 

conventions and guidelines 513 
CICS/VS VTAM terminal control 464 
dynamic transaction backout 384 
TCAM 483 

transaction backout program 427 
user input exit 421 
user prefix 409 
user prefix creation 58 
user—supplied abend code 225 
user—supplied error processors, DFHSNEP 
TYP E=ERRPROC 371 

userewritten node error programs 369 
common subroutine vector table 373 
default transaction—class routine 370 
DFHZNEPI macros 369 
DFHZNEPI TYPE=INITIAL 370 
error status blocks 373 
NEPCLAS operand 171 
node error blocks 373 
node error table header Node Error 
Table Headers This 373 
user-written error processors 371 
user-written terminal error programs 348 
abend transaction bit 353 
address contents of TACLE 348 
DFHTEP recursive retry routine 354 
disconnect switched line bit 353 
dummy terminal indicator 353 
example 354 

format description of TACLE DSECT 350 
non—purgeable task 3 53 
switched line disconnected bit 353 
TACLE action bits 352 

TACLE, action and information bits 352 
write abort 353 


VERIFY=YES operand 132 
Version 1 compatibility 20,41 
VF operand 297 
virtual storage 569 

application programs 580 
CICS/VS dynamic storage area 578 
estimating requirements 616 
operating system and major access 
method requirements 569 
OSCOR definition 580 
static CICS/VS area requirements 570 
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VOLERR operand 399,403 
volume error 399 
VOLUME operand 399 
volume switching 149 
VRC/LRC checking feature 256 
VSAM 

buffer space 125 
buffer storage 579 
buffers 125 
enhancements 21 
ICIP and mixed mode files 544 
mixed mode files — DFHFCT 
TY PE=ALTE RN ATE 118 
operand 18 
reference set 589 
shared resources 18 
shared resources control — DFHFCT 
TYPE=SHRCTL 143 
storage requirements 589 
VSAME operand 21 
VSAMSHR operand 18 
VSAME operand 21 
VSAMSHR operand 18 
VTAM 447 

access method control block (ACB) 449 
action flags set by DFHZNAC 460 
APPLID operand 449 
BMS 465 

BMSDEV operand 465 

BUFFER operand 453 

chain assembly (CHNASSY) 452 

CICS/VS good morning message 235 

CON NE CT=AUTO 450 

control blocks 587 

devices 79 

DFHPCT TYPE=OPTGRP 455 
DFHTC CTYPE=COMMAND 449 
DFHTC CTYPE=STATUS 463 
DFHTCP, DFHZCP 448 
DFHZNAC 681 

DFHZNAC logging facility 462 
DVSUPRT operand 463 
emergency restart 457 
error actions 681 
I/O error handling 

DFHZNAC/DFHZNEP 458 
indicators 

DFHTC CTYPE=CQMMAND 527,534 
JFILEID operand 463 
logical record presentation 465 
logical units with CICS/VS 447 
mapping individual records and entire 
chains 465 
message cache 457 
message logging 455 
message option groups 455 
message protection processing 455 
message recovery 454 
message recovery and emergency 
restart 454 
message switching 466 
MSGJRNL operand 463 
MSGPREQ operand 455 

multiprocessor recovery procedures 438 
node abnormal condition program 458 
node initialization block (NIB) 450 
noncatastrophic failures 458 
nonprotected tasks 455 


VTAM (continued) 
operand 19 
protected tasks 455 
RAMAX operand 452 
RATIMES operand 452 
RECEIVE macro 451 
reference set 586 
RELREQ exit—routine 451 
ROUTING operand 465 
RPLs 451 
session types 275 
SIMLOGON 282 
size of RPL pool 466 
SNA commands 

DFHTC CTYPE=COMMAND 534 
SNA commands (indicators) 449 
statistics 466 
storage requirements 587 
system sense codes received 698 
terminal control, DFHTC macros 462 
terminal/logical units 275 
transaction class 459 
transaction options 462 
transaction-class error routine 459 
TRMIDNT operand 466 
TRMSTAT operand 463 

user exit routines for CICS/VS terminal 
control 464 
% ATTACH exit 465 
ZINPUT exit 464 
VTAMDEV operand 79 
V1CMPAT=YES operand 41 


warm keypoint 415 
warm restart 415 

full warm restart 415 
system generation 89 
table preparation 312 
warm keypoint 415 
weighted retrieval function, DFHSG 
PRO GRAM=BFP 25 

when abnormal condition occurs 325,361 
node error program 361 
sample node error program 361 
sample terminal error program 327 
terminal abnormal condition line entry 
(TACLE) 326 

terminal error program 325 
user—written node error programs 369 
user-written terminal error 
programs 348 
work area 484 
working storage 578 
WRAPLST operand 8 0 
write abort 353 
WRKAREA operand 36,215 


XATTACH exit, TCAM 483 
XATTACH operand 80 
XDERROR operand 43,68 
XDSPCHR operand 59 
XFERROR operand 44,68 
XFETCH operand 64 
XICEEXP operand 54 
XINIT operand 

DFHSG PROGRAM=DBP 44 
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XINIT operand (continued) 

DFHSG PROGRAM=TB P 68 
XINPUT operand 

DFHSG PROGRAM=DBP 43 
DFHSG PROGRAM=FCP 50 
DFHSG PROGRAM=TBP 68 
DFHSG PROGRAM =TCP 80 
DFHSG PROGRAM=TDP 83 
DFHSG PROGRAM=TSP 86.1 
XINPUTC operand 51 
XLT operand 215 

XLT, transaction list table (see 
DFHXLT) 308 
XOUTPUT operand 

DFHSG PROGRAM=FCP 51 
DFHSG PROGRAM=TCP 80 
DFHSG PROGRAM=TDP 84 
DFHSG PROGRAM=TSP 86 
XRDATT operand 80 
XTCMIN exit, TCAM 483 
XTCMIN operand 81 
XTCMOUT exit, TCAM 484 
XTCMOUT operand 81 
XTRANID operand 175 
XTYPREQ operand 

DFHSG PROGRAM=FCP 51 
DFHSG PROGRAM=ICP 54 
DFHSG PROGRAM=KCP 59 
DFHSG PROGRAM=SCP 66 
DFHSG PROGRAM=TDP 84 
DFHSG PROGRAM=TSP 87 


ZATTACH exit, VTAM 465 
ZATTACH operand 80 
ZCP operand 215 
ZINPUT exit, VTAM 464 
ZINPUT operand 81 
ZOUTPUT operand 81 


1050 data communication system, TCT 
example 630 


2260 display station 
CMPT60L operand 73 
COMPAT operand 

DFHPCT TYPE=ENTRY 168 
DFHSG PROGRAM=TCP 74 
DFHTCT TYPE=TERMINAL 282 
compatibility for 3270 493 

table preparation 494 
FEATURE operand 494 
FMT2260 operand 75 
FORMAT mode 493 
formatted screen 495 
FULLBUF mode 493 
initiating transactions 499 
line addressing 49 9 
lock feature 499 
model—dependent data stream 495 
modes of 3270 compatibility 
FORMAT mode 493 
FULLBUF mode 493 
new-line symbol (NL) 498 
screen format 261,295 
screen formats 75 


2260 display station (continued) 
screen techniques 495 
start-of-message indicator (SMI) 498 
tab feature 496 
TCT examples 
local 650 
remote 631 

2845/2848 tab feature 499 


2314 direct access storage facility, TCT 
example 648 


2540 card read punch/1403 printer, TCT 
example 64 7 


2740 communication terminal 

model 2, 10—second delay 358 
TCT example 632 


2741 communication terminal, TCT 
example 632 


2770 data communication system, TCT 
example 642 


2780 data transmission terminal, TCT 
example 642 


2845/2848 tab feature 499 


2980 general banking terminal system, TCT 
example 638 


3270 information display system 
generate logical units 275 
large screen support 
ALTPGE operand 277 
ALTSCRN operand 278 
DEFSCRN operand 283. 

SCRNSZE operand 163,172 
locked buffer, DFHTEP 360 
PA/PF keys 164 

printer authorization matrix 211 
printer selection 

ALTPRT operand 290 
PRINTTO operand 290 
TCAM 482 
TCT examples 
BTAM 639 

BTAM, local (OS/VS) 649 
large screen support 657 
VTAM 657 
327 5 (DOS/VS) 644 
unavailable printer 
DFHTEP 359 
DFHZNEP 374 
2260 compatibility 493 
3275 dialed 30—second timeout, 
DFHTEP 360 
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3600 finance communication system 
generate logical units 275 
TCT example 653 


3600 finance communication system (BSc) 
buffer depletion 506 
poll list 505 
system generation 505 
TCT example 641 

terminal control table preparation 505 


3790 communication system 

generate logical units 275 
TCT examples 

batch data interchange LU 661 
extended local LDC list 662 
full function LU 660 
inquiry LU 661 
SCS printer LU 660 
3270-display LU 659 
3270—printer LU 660 
3270—compatible LUs 275 


3600 pipeline logical unit, TCT 
example 654 


3614 consumer transaction facility, TCT 
example 654 


7770 audio response unit 
DOS/VS TCT example 634 
OS/VS TCT example 633 
32-second timeout 357 


3650 retail store system 

generate logical units 275 
TCT examples 

host command processor LU 656 
host conversational (3270) LU 656 
host conversational (3653) LU 655 
interpreter LU 656 
pipeline LU 655 


3735 programmable buffered terminal 
inquiry mode 501 
system generation 501 
TCT example 645 

terminal control table preparation 501 


3740 data entry system 
ID verification 503 
system generation 503 
TCT examples 

dial/switched pOS/VS) 646 
multipoint (DOS/VS) 640 
point-to-point 647 

terminal control table preparation 503 


3767 communication terminal 
generate logical units 275 
TCT example 658 


3770 data communication system 
generate logical units 275 
TCT examples 

batch data interchange LU 659 
extended local LDC list 662 
full function LU 659 
LDCs for batch LU 6 61 
non—programmable 658 


3780 data communication terminal, TCT 
example 640 


752 


CICS/VS System Programmer's Reference Manual 





